google-api-python-client 2.140.0__py2.py3-none-any.whl → 2.142.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/doubleclickbidmanager.v2.json

@@ -107,7 +107,7 @@
 "queries": {
 "methods": {
 "create": {
-"description": "Creates a query.",
+"description": "Creates a new query.",
 "flatPath": "queries",
 "httpMethod": "POST",
 "id": "doubleclickbidmanager.queries.create",
@@ -125,7 +125,7 @@
 ]
 },
 "delete": {
-"description": "Deletes a query as well as the associated reports.",
+"description": "Deletes an existing query as well as its generated reports.",
 "flatPath": "queries/{queryId}",
 "httpMethod": "DELETE",
 "id": "doubleclickbidmanager.queries.delete",
@@ -134,7 +134,7 @@
 ],
 "parameters": {
 "queryId": {
-"description": "Required. ID of query to delete.",
+"description": "Required. The ID of the query to delete.",
 "format": "int64",
 "location": "path",
 "required": true,
@@ -156,7 +156,7 @@
 ],
 "parameters": {
 "queryId": {
-"description": "Required. ID of query to retrieve.",
+"description": "Required. The ID of the query to retrieve.",
 "format": "int64",
 "location": "path",
 "required": true,
@@ -179,7 +179,7 @@
 "parameterOrder": [],
 "parameters": {
 "orderBy": {
-"description": "Name of a field used to order results. The default sorting order is ascending. To specify descending order for a field, append a \" desc\" suffix. For example \"metadata.title desc\". Sorting is only supported for the following fields: * `queryId` * `metadata.title`",
+"description": "Field to sort the list by. Accepts the following values: * `queryId` (default) * `metadata.title` The default sorting order is ascending. To specify descending order for a field, add the suffix `desc` to the field name. For example, `queryId desc`.",
 "location": "query",
 "type": "string"
 },
@@ -190,7 +190,7 @@
 "type": "integer"
 },
 "pageToken": {
-"description": "A page token, received from a previous list call. Provide this to retrieve the subsequent page of queries.",
+"description": "A token identifying which page of results the server should return. Typically, this is the value of nextPageToken, returned from the previous call to the `queries.list` method. If unspecified, the first page of results is returned.",
 "location": "query",
 "type": "string"
 }
@@ -204,7 +204,7 @@
 ]
 },
 "run": {
-"description": "Runs a stored query to generate a report.",
+"description": "Runs an existing query to generate a report.",
 "flatPath": "queries/{queryId}:run",
 "httpMethod": "POST",
 "id": "doubleclickbidmanager.queries.run",
@@ -213,14 +213,14 @@
 ],
 "parameters": {
 "queryId": {
-"description": "Required. ID of query to run.",
+"description": "Required. The ID of the query to run.",
 "format": "int64",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "synchronous": {
-"description": "Whether the query should be run synchronously. When true, this method will not return until the query has finished running. When false or not specified, this method will return immediately.",
+"description": "Whether the query should be run synchronously. When `true`, the request won't return until the resulting report has finished running. This parameter is `false` by default. Setting this parameter to `true` is **not recommended**.",
 "location": "query",
 "type": "boolean"
 }
@@ -251,14 +251,14 @@
 ],
 "parameters": {
 "queryId": {
-"description": "Required. ID of the query the report is associated with.",
+"description": "Required. The ID of the query that generated the report.",
 "format": "int64",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "reportId": {
-"description": "Required. ID of the report to retrieve.",
+"description": "Required. The ID of the query to retrieve.",
 "format": "int64",
 "location": "path",
 "required": true,
@@ -274,7 +274,7 @@
 ]
 },
 "list": {
-"description": "Lists reports associated with a query.",
+"description": "Lists reports generated by the provided query.",
 "flatPath": "queries/{queryId}/reports",
 "httpMethod": "GET",
 "id": "doubleclickbidmanager.queries.reports.list",
@@ -283,7 +283,7 @@
 ],
 "parameters": {
 "orderBy": {
-"description": "Name of a field used to order results. The default sorting order is ascending. To specify descending order for a field, append a \" desc\" suffix. For example \"key.reportId desc\". Sorting is only supported for the following fields: * `key.reportId`",
+"description": "Field to sort the list by. Accepts the following values: * `key.reportId` (default) The default sorting order is ascending. To specify descending order for a field, add the suffix `desc` to the field name. For example, `key.reportId desc`.",
 "location": "query",
 "type": "string"
 },
@@ -294,12 +294,12 @@
 "type": "integer"
 },
 "pageToken": {
-"description": "A page token, received from a previous list call. Provide this to retrieve the subsequent page of reports.",
+"description": "A token identifying which page of results the server should return. Typically, this is the value of nextPageToken returned from the previous call to the `queries.reports.list` method. If unspecified, the first page of results is returned.",
 "location": "query",
 "type": "string"
 },
 "queryId": {
-"description": "Required. ID of the query with which the reports are associated.",
+"description": "Required. The ID of the query that generated the reports.",
 "format": "int64",
 "location": "path",
 "required": true,
@@ -319,23 +319,23 @@
 }
 }
 },
-"revision": "20240626",
+"revision": "20240731",
 "rootUrl": "https://doubleclickbidmanager.googleapis.com/",
 "schemas": {
 "DataRange": {
-"description": "Report data range.",
+"description": "The date range to be reported on.",
 "id": "DataRange",
 "properties": {
 "customEndDate": {
 "$ref": "Date",
-"description": "The ending date for the data that is shown in the report. Note, `customEndDate` is required if `range` is `CUSTOM_DATES` and ignored otherwise."
+"description": "If `CUSTOM_DATES` is assigned to range, this field specifies the end date for the date range that is reported on. This field is required if using `CUSTOM_DATES` range and will be ignored otherwise."
 },
 "customStartDate": {
 "$ref": "Date",
-"description": "The starting data for the data that is shown in the report. Note, `customStartDate` is required if `range` is `CUSTOM_DATES` and ignored otherwise."
+"description": "If `CUSTOM_DATES` is assigned to range, this field specifies the starting date for the date range that is reported on. This field is required if using `CUSTOM_DATES` range and will be ignored otherwise."
 },
 "range": {
-"description": "Report data range used to generate the report.",
+"description": "The preset date range to be reported on. If `CUSTOM_DATES` is assigned to this field, fields custom_start_date and custom_end_date must be set to specify the custom date range.",
 "enum": [
 "RANGE_UNSPECIFIED",
 "CUSTOM_DATES",
@@ -359,7 +359,7 @@
 ],
 "enumDescriptions": [
 "Default value when range is not specified or is unknown in this version.",
-"Custom range specified by custom_start_date and custom_end_date fields.",
+"Custom date range.",
 "Current day.",
 "Previous day.",
 "All days, including the current day, since the most recent Sunday.",
@@ -406,15 +406,15 @@
 "type": "object"
 },
 "FilterPair": {
-"description": "Filter used to match traffic data in your report.",
+"description": "Represents a single filter rule.",
 "id": "FilterPair",
 "properties": {
 "type": {
-"description": "Filter type.",
+"description": "The type of value to filter by. Defined by a [Filter](/bid-manager/reference/rest/v2/filters-metrics#filters) value.",
 "type": "string"
 },
 "value": {
-"description": "Filter value.",
+"description": "The identifying value to filter by, such as a relevant resource ID.",
 "type": "string"
 }
 },
@@ -424,11 +424,11 @@
 "id": "ListQueriesResponse",
 "properties": {
 "nextPageToken": {
-"description": "A token, which can be sent as page_token to retrieve the next page of queries. If this field is omitted, there are no subsequent pages.",
+"description": "A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `queries.list` method to retrieve the next page of results.",
 "type": "string"
 },
 "queries": {
-"description": "The list of queries.",
+"description": "The list of queries. This field will be absent if empty.",
 "items": {
 "$ref": "Query"
 },
@@ -441,11 +441,11 @@
 "id": "ListReportsResponse",
 "properties": {
 "nextPageToken": {
-"description": "A token, which can be sent as page_token to retrieve the next page of reports. If this field is omitted, there are no subsequent pages.",
+"description": "A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `queries.reports.list` method to retrieve the next page of results.",
 "type": "string"
 },
 "reports": {
-"description": "Retrieved reports.",
+"description": "The list of reports. This field will be absent if empty.",
 "items": {
 "$ref": "Report"
 },
@@ -455,36 +455,36 @@
 "type": "object"
 },
 "Options": {
-"description": "Additional query options.",
+"description": "Report parameter options.",
 "id": "Options",
 "properties": {
 "includeOnlyTargetedUserLists": {
-"description": "Set to true and filter your report by `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` to include data for audience lists specifically targeted by those items.",
+"description": "Whether to include data for audience lists specifically targeted by filtered line items or insertion orders. Requires the use of `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` filters.",
 "type": "boolean"
 }
 },
 "type": "object"
 },
 "Parameters": {
-"description": "Parameters of a query or report.",
+"description": "Parameters of a generated report.",
 "id": "Parameters",
 "properties": {
 "filters": {
-"description": "Filters used to match traffic data in your report.",
+"description": "Filters to limit the scope of reported data.",
 "items": {
 "$ref": "FilterPair"
 },
 "type": "array"
 },
 "groupBys": {
-"description": "Data is grouped by the filters listed in this field.",
+"description": "Dimensions by which to segment and group the data. Defined by [Filter](/bid-manager/reference/rest/v2/filters-metrics#filters) values.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "metrics": {
-"description": "Metrics to include as columns in your report.",
+"description": "Metrics to define the data populating the report. Defined by [Metric](/bid-manager/reference/rest/v2/filters-metrics#metrics) values.",
 "items": {
 "type": "string"
 },
@@ -492,10 +492,10 @@
 },
 "options": {
 "$ref": "Options",
-"description": "Additional query options."
+"description": "Additional report parameter options."
 },
 "type": {
-"description": "The type of the report. The type of the report will dictate what dimesions, filters, and metrics can be used.",
+"description": "The type of the report. The type of the report determines the dimesions, filters, and metrics that can be used.",
 "enum": [
 "REPORT_TYPE_UNSPECIFIED",
 "STANDARD",
@@ -544,40 +544,40 @@ true
 "type": "object"
 },
 "Query": {
-"description": "Represents a query.",
+"description": "A single query used to generate a report.",
 "id": "Query",
 "properties": {
 "metadata": {
 "$ref": "QueryMetadata",
-"description": "Query metadata."
+"description": "The metadata of the query."
 },
 "params": {
 "$ref": "Parameters",
-"description": "Query parameters."
+"description": "The parameters of the report generated by the query."
 },
 "queryId": {
-"description": "Output only. Query ID.",
+"description": "Output only. The unique ID of the query.",
 "format": "int64",
 "readOnly": true,
 "type": "string"
 },
 "schedule": {
 "$ref": "QuerySchedule",
-"description": "Information on how often and when to run a query. If `ONE_TIME` is set to the frequency field, the query will only be run at the time of creation."
+"description": "When and how often the query is scheduled to run. If the frequency field is set to `ONE_TIME`, the query will only run when queries.run is called."
 }
 },
 "type": "object"
 },
 "QueryMetadata": {
-"description": "Query metadata.",
+"description": "The metadata of the query.",
 "id": "QueryMetadata",
 "properties": {
 "dataRange": {
 "$ref": "DataRange",
-"description": "Range of report data. All reports will be based on the same time zone as used by the advertiser."
+"description": "The date range the report generated by the query will report on. This date range will be defined by the time zone as used by the advertiser."
 },
 "format": {
-"description": "Format of the generated report.",
+"description": "The format of the report generated by the query.",
 "enum": [
 "FORMAT_UNSPECIFIED",
 "CSV",
@@ -591,33 +591,33 @@ true
 "type": "string"
 },
 "sendNotification": {
-"description": "Whether to send an email notification when a report is ready. Defaults to false.",
+"description": "Whether an email notification is sent to the query creator when a report generated by the query is ready. This value is `false` by default.",
 "type": "boolean"
 },
 "shareEmailAddress": {
-"description": "List of email addresses which are sent email notifications when the report is finished. Separate from send_notification.",
+"description": "List of additional email addresses with which to share the query. If send_notification is `true`, these email addresses will receive a notification when a report generated by the query is ready. If these email addresses are connected to Display & Video 360 users, the query will be available to them in the Display & Video 360 interface.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "title": {
-"description": "Query title. It is used to name the reports generated from this query.",
+"description": "The display name of the query. This value will be used in the file name of reports generated by the query.",
 "type": "string"
 }
 },
 "type": "object"
 },
 "QuerySchedule": {
-"description": "Information on when and how frequently to run a query.",
+"description": "Settings on when and how frequently to run a query.",
 "id": "QuerySchedule",
 "properties": {
 "endDate": {
 "$ref": "Date",
-"description": "Date to periodically run the query until. Not applicable to `ONE_TIME` frequency."
+"description": "The date on which to end the scheduled runs. This field is required if frequency is not set to `ONE_TIME`. Otherwise, it will be ignored."
 },
 "frequency": {
-"description": "How often the query is run.",
+"description": "How frequently to run the query. If set to `ONE_TIME`, the query will only be run when queries.run is called.",
 "enum": [
 "FREQUENCY_UNSPECIFIED",
 "ONE_TIME",
@@ -630,58 +630,58 @@ true
 ],
 "enumDescriptions": [
 "Default value when frequency is not specified or is unknown in this version.",
-"Only once.",
+"Only when the query is run manually.",
 "Once a day.",
 "Once a week.",
 "Twice a month.",
 "Once a month.",
-"Once a quarter",
+"Once a quarter.",
 "Once a year."
 ],
 "type": "string"
 },
 "nextRunTimezoneCode": {
-"description": "Canonical timezone code for report generation time. Defaults to `America/New_York`.",
+"description": "The canonical code for the timezone the query schedule is based on. Scheduled runs are usually conducted in the morning of a given day. Defaults to `America/New_York`.",
 "type": "string"
 },
 "startDate": {
 "$ref": "Date",
-"description": "When to start running the query. Not applicable to `ONE_TIME` frequency."
+"description": "The date on which to begin the scheduled runs. This field is required if frequency is not set to `ONE_TIME`. Otherwise, it will be ignored."
 }
 },
 "type": "object"
 },
 "Report": {
-"description": "Represents a report.",
+"description": "A single report generated by its parent report.",
 "id": "Report",
 "properties": {
 "key": {
 "$ref": "ReportKey",
-"description": "Key used to identify a report."
+"description": "The key information identifying the report."
 },
 "metadata": {
 "$ref": "ReportMetadata",
-"description": "Report metadata."
+"description": "The metadata of the report."
 },
 "params": {
 "$ref": "Parameters",
-"description": "Report parameters."
+"description": "The parameters of the report."
 }
 },
 "type": "object"
 },
 "ReportKey": {
-"description": "Key used to identify a report.",
+"description": "Identifying information of a report.",
 "id": "ReportKey",
 "properties": {
 "queryId": {
-"description": "Output only. Query ID.",
+"description": "Output only. The unique ID of the query that generated the report.",
 "format": "int64",
 "readOnly": true,
 "type": "string"
 },
 "reportId": {
-"description": "Output only. Report ID.",
+"description": "Output only. The unique ID of the report.",
 "format": "int64",
 "readOnly": true,
 "type": "string"
@@ -690,41 +690,41 @@ true
 "type": "object"
 },
 "ReportMetadata": {
-"description": "Report metadata.",
+"description": "The metadata of a report.",
 "id": "ReportMetadata",
 "properties": {
 "googleCloudStoragePath": {
-"description": "Output only. The path to the location in Google Cloud Storage where the report is stored.",
+"description": "Output only. The location of the generated report file in Google Cloud Storage. This field will be absent if status.state is not `DONE`.",
 "readOnly": true,
 "type": "string"
 },
 "reportDataEndDate": {
 "$ref": "Date",
-"description": "The ending time for the data that is shown in the report."
+"description": "The end date of the report data date range."
 },
 "reportDataStartDate": {
 "$ref": "Date",
-"description": "The starting time for the data that is shown in the report."
+"description": "The start date of the report data date range."
 },
 "status": {
 "$ref": "ReportStatus",
-"description": "Report status."
+"description": "The status of the report."
 }
 },
 "type": "object"
 },
 "ReportStatus": {
-"description": "Report status.",
+"description": "The status of a report.",
 "id": "ReportStatus",
 "properties": {
 "finishTime": {
-"description": "Output only. The time when this report either completed successfully or failed.",
+"description": "Output only. The timestamp of when report generation finished successfully or in failure. This field will not be set unless state is `DONE` or `FAILED`.",
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
 },
 "format": {
-"description": "The file type of the report.",
+"description": "The format of the generated report file.",
 "enum": [
 "FORMAT_UNSPECIFIED",
 "CSV",
@@ -738,7 +738,7 @@ true
 "type": "string"
 },
 "state": {
-"description": "Output only. The state of the report.",
+"description": "Output only. The state of the report generation.",
 "enum": [
 "STATE_UNSPECIFIED",
 "QUEUED",
@@ -760,12 +760,12 @@ true
 "type": "object"
 },
 "RunQueryRequest": {
-"description": "Request to run a stored query to generate a report.",
+"description": "Details specifying how to run a query.",
 "id": "RunQueryRequest",
 "properties": {
 "dataRange": {
 "$ref": "DataRange",
-"description": "Report data range used to generate the report. If unspecified, the original parent query's data range is used."
+"description": "The date range used by the query to generate the report. If unspecified, the query's original data_range is used."
 }
 },
 "type": "object"

googleapiclient/discovery_cache/documents/drive.v2.json

@@ -3869,7 +3869,7 @@
 }
 }
 },
-"revision": "20240722",
+"revision": "20240809",
 "rootUrl": "https://www.googleapis.com/",
 "schemas": {
 "About": {
@@ -5469,7 +5469,7 @@
 },
 "lastModifyingUser": {
 "$ref": "User",
-"description": "Output only. The last user to modify this file."
+"description": "Output only. The last user to modify this file. This field is only populated when the last modification was performed by a signed-in user."
 },
 "lastModifyingUserName": {
 "description": "Output only. Name of the last user to modify this file.",
@@ -5547,7 +5547,7 @@
 "type": "array"
 },
 "parents": {
-"description": "Collection of parent folders which contain this file. If not specified as part of an insert request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests can also use the `addParents` and `removeParents` parameters to modify the parents list.",
+"description": "The ID of the parent folder containing the file. A file can only have one parent folder; specifying multiple parents isn't supported. If not specified as part of an insert request, the file is placed directly in the user's My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parent of the source file. Update requests must use the `addParents` and `removeParents` parameters to modify the parents list.",
 "items": {
 "$ref": "ParentReference"
 },
@@ -5659,7 +5659,7 @@
 "type": "object"
 },
 "thumbnailLink": {
-"description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.",
+"description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Not intended for direct usage on web applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS), consider using a proxy server. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.",
 "type": "string"
 },
 "thumbnailVersion": {
@@ -6049,7 +6049,7 @@
 "type": "object"
 },
 "ParentReference": {
-"description": "A reference to a file's parent. Some resource methods (such as `parents.get`) require a `parentId`. Use the `parents.list` method to retrieve the ID for a parent.",
+"description": "A reference to a file's parent. A file can only have one parent folder; specifying multiple parents isn't supported. Some resource methods (such as `parents.get`) require a `parentId`. Use the `parents.list` method to retrieve the ID for a parent.",
 "id": "ParentReference",
 "properties": {
 "id": {
@@ -6394,7 +6394,7 @@
 },
 "lastModifyingUser": {
 "$ref": "User",
-"description": "Output only. The last user to modify this revision."
+"description": "Output only. The last user to modify this revision. This field is only populated when the last modification was performed by a signed-in user."
 },
 "lastModifyingUserName": {
 "description": "Output only. Name of the last user to modify this revision.",

googleapiclient/discovery_cache/documents/drive.v3.json

@@ -2523,7 +2523,7 @@
 }
 }
 },
-"revision": "20240722",
+"revision": "20240809",
 "rootUrl": "https://www.googleapis.com/",
 "schemas": {
 "About": {
@@ -3735,7 +3735,7 @@
 },
 "lastModifyingUser": {
 "$ref": "User",
-"description": "Output only. The last user to modify the file."
+"description": "Output only. The last user to modify the file. This field is only populated when the last modification was performed by a signed-in user."
 },
 "linkShareMetadata": {
 "description": "Contains details about the link URLs that clients are using to refer to this item.",
@@ -3793,7 +3793,7 @@
 "type": "array"
 },
 "parents": {
-"description": "The IDs of the parent folders which contain the file. If not specified as part of a create request, the file is placed directly in the user's My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parents of the source file. Update requests must use the `addParents` and `removeParents` parameters to modify the parents list.",
+"description": "The ID of the parent folder containing the file. A file can only have one parent folder; specifying multiple parents isn't supported. If not specified as part of a create request, the file is placed directly in the user's My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parent of the source file. Update requests must use the `addParents` and `removeParents` parameters to modify the parents list.",
 "items": {
 "type": "string"
 },
@@ -3890,7 +3890,7 @@
 "type": "string"
 },
 "thumbnailLink": {
-"description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.",
+"description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Not intended for direct usage on web applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) policies, consider using a proxy server. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.",
 "type": "string"
 },
 "thumbnailVersion": {
@@ -4494,7 +4494,7 @@
 },
 "lastModifyingUser": {
 "$ref": "User",
-"description": "Output only. The last user to modify this revision."
+"description": "Output only. The last user to modify this revision. This field is only populated when the last modification was performed by a signed-in user."
 },
 "md5Checksum": {
 "description": "Output only. The MD5 checksum of the revision's content. This is only applicable to files with binary content in Drive.",