From 41be8e897ece164d89f457c7ebbbafefd4cc357e Mon Sep 17 00:00:00 2001
From: Joe Gregorio
BASE = 'docs/dyn'
-DIRECTORY_URI = 'https://www.googleapis.com/discovery/v1/apis?preferred=true',
+DIRECTORY_URI = 'https://www.googleapis.com/discovery/v1/apis?preferred=true'
FLAGS = gflags.FLAGS
diff --git a/docs/dyn/adsensehost_v4_1.associationsessions.html b/docs/dyn/adsensehost_v4_1.associationsessions.html
index 00c8775..2bd44a5 100644
--- a/docs/dyn/adsensehost_v4_1.associationsessions.html
+++ b/docs/dyn/adsensehost_v4_1.associationsessions.html
@@ -89,8 +89,10 @@ Args:
productCode: string, Products to associate with the user. (required) (repeated)
Allowed values
AFC - AdSense For Content
+ AFG - AdSense For Games
AFMC - AdSense For Mobile Content
AFS - AdSense For Search
+ AFV - AdSense For Video
websiteUrl: string, The URL of the user's hosted website. (required)
websiteLocale: string, The locale of the user's hosted website.
userLocale: string, The preferred locale of the user.
diff --git a/docs/dyn/audit_v1.activities.html b/docs/dyn/audit_v1.activities.html
index 5da7168..a869ae5 100644
--- a/docs/dyn/audit_v1.activities.html
+++ b/docs/dyn/audit_v1.activities.html
@@ -75,11 +75,11 @@ h1, h2, h3 {
Enterprise Audit API . activities
Instance Methods
+ list(customerId, applicationId, caller=None, startTime=None, actorIpAddress=None, eventName=None, actorApplicationId=None, continuationToken=None, maxResults=None, actorEmail=None, endTime=None)
Retrieves a list of activities for a specific customer and application.
list(customerId, applicationId, caller=None, startTime=None, actorIpAddress=None, eventName=None, actorApplicationId=None, continuationToken=None, maxResults=None, parameters=None, actorEmail=None, endTime=None)
+ list(customerId, applicationId, caller=None, startTime=None, actorIpAddress=None, eventName=None, actorApplicationId=None, continuationToken=None, maxResults=None, actorEmail=None, endTime=None)
Retrieves a list of activities for a specific customer and application.
Args:
@@ -95,7 +95,6 @@ Args:
actorApplicationId: string, Application ID of the application which interacted on behalf of the user while performing the event.
continuationToken: string, Next page URL.
maxResults: integer, Number of activity records to be shown in each page.
- parameters: string, Event parameters in the form [parameter1 name]:[parameter1 value],[parameter2 name]:[parameter2 value],...
actorEmail: string, Email address of the user who performed the action.
endTime: string, Return events which occured at or before this time.
diff --git a/docs/dyn/bigquery_v2.jobs.html b/docs/dyn/bigquery_v2.jobs.html
index 70b0098..26cc5ab 100644
--- a/docs/dyn/bigquery_v2.jobs.html
+++ b/docs/dyn/bigquery_v2.jobs.html
@@ -144,34 +144,34 @@ Returns:
"etag": "A String", # [Output-only] A hash of this resource.
"configuration": { # [Required] Describes the job configuration.
"load": { # [Pick one] Configures a load job.
- "encoding": "A String", # [Optional] Character encoding of the input data. May be UTF-8 or ISO-8859-1. Default is UTF-8.
- "fieldDelimiter": "A String", # [Optional] Delimiter to use between fields in the import data. Default is ','. Note that delimiters are applied to the raw, binary data before the encoding is applied.
- "sourceFormat": "A String", # [Experimental] Optional and defaults to CSV. Format of source files. For CSV uploads, specify "CSV". For imports of datastore backups, specify "DATASTORE_BACKUP". For imports of newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON".
- "destinationTable": { # [Required] Table being written to.
+ "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties.
+ "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (',').
+ "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". The default value is CSV.
+ "destinationTable": { # [Required] The destination table to load the data into.
"projectId": "A String", # [Required] ID of the project billed for storage of the table.
"tableId": "A String", # [Required] ID of the table.
"datasetId": "A String", # [Required] ID of the dataset containing the table.
},
- "writeDisposition": "A String", # [Optional] Whether to overwrite an existing table (WRITE_TRUNCATE), append to an existing table (WRITE_APPEND), or require that the the table is empty (WRITE_EMPTY). Default is WRITE_APPEND.
- "maxBadRecords": 42, # [Optional] Maximum number of bad records that should be ignored before the entire job is aborted and no updates are performed.
- "skipLeadingRows": 42, # [Optional] Number of rows of initial data to skip in the data being imported.
- "sourceUris": [ # [Required] Source URIs describing Google Cloud Storage locations of data to load.
+ "writeDisposition": "A String", # [Optional] Specifies the action that occurs if the destination table already exists. Each action is atomic and only occurs if BigQuery is able to fully load the data and the load job completes without error. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists, a 'duplicate' error is returned in the job result. Creation, truncation and append actions occur as one atomic update upon job completion.
+ "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an 'invalid' error is returned in the job result and the job fails. The default value is 0, which requires that all records are valid.
+ "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.
+ "sourceUris": [ # [Required] The fully-qualified URIs that point to your data on Google Cloud Storage.
"A String",
],
- "quote": "A String", # [Optional] Quote character to use. Default is '"'. Note that quoting is done on the raw, binary data before the encoding is applied. If no quoting is done, use am empty string.
- "createDisposition": "A String", # [Optional] Whether to create the table if it doesn't already exist (CREATE_IF_NEEDED) or to require the table already exist (CREATE_NEVER). Default is CREATE_IF_NEEDED.
- "schemaInlineFormat": "A String", # [Experimental] Format of inlineSchema field.
- "schemaInline": "A String", # [Experimental] Inline schema. For CSV schemas, specify as "Field1:Type1[,Field2:Type2]*". For example, "foo:STRING, bar:INTEGER, baz:FLOAT"
- "allowQuotedNewlines": True or False, # [Experimental] Whether to allow quoted newlines in the source CSV data.
- "schema": { # [Optional] Schema of the table being written to.
+ "quote": "A String", # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true.
+ "createDisposition": "A String", # [Optional] Specifies whether the job is allowed to create new tables. The following values are supported: CREATE_IF_NEEDED: If the table does not exist, BigQuery creates the table. CREATE_NEVER: The table must already exist. If it does not, a 'notFound' error is returned in the job result. The default value is CREATE_IF_NEEDED. Creation, truncation and append actions occur as one atomic update upon job completion.
+ "schemaInlineFormat": "A String", # [Deprecated] The format of the schemaInline property.
+ "schemaInline": "A String", # [Deprecated] The inline schema. For CSV schemas, specify as "Field1:Type1[,Field2:Type2]*". For example, "foo:STRING, bar:INTEGER, baz:FLOAT".
+ "allowQuotedNewlines": True or False, # Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false.
+ "schema": { # [Optional] The schema for the destination table. The schema can be omitted if the destination table already exists or if the schema can be inferred from the loaded data.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -200,6 +200,7 @@ Returns:
},
"priority": "A String", # [Optional] Specifies a priority for the query. Default is INTERACTIVE. Alternative is BATCH.
"writeDisposition": "A String", # [Optional] Whether to overwrite an existing table (WRITE_TRUNCATE), append to an existing table (WRITE_APPEND), or require that the the table is empty (WRITE_EMPTY). Default is WRITE_EMPTY.
+ "allowLargeResults": True or False, # [Experimental] If true, allows >128M results to be materialized in the destination table. Requires destination_table to be set.
"createDisposition": "A String", # [Optional] Whether to create the table if it doesn't already exist (CREATE_IF_NEEDED) or to require the table already exist (CREATE_NEVER). Default is CREATE_IF_NEEDED.
"query": "A String", # [Required] BigQuery SQL query to execute.
"preserveNulls": True or False, # [Experimental] If set, preserve null values in table data, rather than mapping null values to the column's default value. This flag currently defaults to false, but the default will soon be changed to true. Shortly afterward, this flag will be removed completely. Please specify true if possible, and false only if you need to force the old behavior while updating client code.
@@ -273,12 +274,12 @@ Returns:
"schema": { # The schema of the results. Present only when the query completes successfully.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -334,34 +335,34 @@ Args:
"etag": "A String", # [Output-only] A hash of this resource.
"configuration": { # [Required] Describes the job configuration.
"load": { # [Pick one] Configures a load job.
- "encoding": "A String", # [Optional] Character encoding of the input data. May be UTF-8 or ISO-8859-1. Default is UTF-8.
- "fieldDelimiter": "A String", # [Optional] Delimiter to use between fields in the import data. Default is ','. Note that delimiters are applied to the raw, binary data before the encoding is applied.
- "sourceFormat": "A String", # [Experimental] Optional and defaults to CSV. Format of source files. For CSV uploads, specify "CSV". For imports of datastore backups, specify "DATASTORE_BACKUP". For imports of newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON".
- "destinationTable": { # [Required] Table being written to.
+ "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties.
+ "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (',').
+ "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". The default value is CSV.
+ "destinationTable": { # [Required] The destination table to load the data into.
"projectId": "A String", # [Required] ID of the project billed for storage of the table.
"tableId": "A String", # [Required] ID of the table.
"datasetId": "A String", # [Required] ID of the dataset containing the table.
},
- "writeDisposition": "A String", # [Optional] Whether to overwrite an existing table (WRITE_TRUNCATE), append to an existing table (WRITE_APPEND), or require that the the table is empty (WRITE_EMPTY). Default is WRITE_APPEND.
- "maxBadRecords": 42, # [Optional] Maximum number of bad records that should be ignored before the entire job is aborted and no updates are performed.
- "skipLeadingRows": 42, # [Optional] Number of rows of initial data to skip in the data being imported.
- "sourceUris": [ # [Required] Source URIs describing Google Cloud Storage locations of data to load.
+ "writeDisposition": "A String", # [Optional] Specifies the action that occurs if the destination table already exists. Each action is atomic and only occurs if BigQuery is able to fully load the data and the load job completes without error. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists, a 'duplicate' error is returned in the job result. Creation, truncation and append actions occur as one atomic update upon job completion.
+ "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an 'invalid' error is returned in the job result and the job fails. The default value is 0, which requires that all records are valid.
+ "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.
+ "sourceUris": [ # [Required] The fully-qualified URIs that point to your data on Google Cloud Storage.
"A String",
],
- "quote": "A String", # [Optional] Quote character to use. Default is '"'. Note that quoting is done on the raw, binary data before the encoding is applied. If no quoting is done, use am empty string.
- "createDisposition": "A String", # [Optional] Whether to create the table if it doesn't already exist (CREATE_IF_NEEDED) or to require the table already exist (CREATE_NEVER). Default is CREATE_IF_NEEDED.
- "schemaInlineFormat": "A String", # [Experimental] Format of inlineSchema field.
- "schemaInline": "A String", # [Experimental] Inline schema. For CSV schemas, specify as "Field1:Type1[,Field2:Type2]*". For example, "foo:STRING, bar:INTEGER, baz:FLOAT"
- "allowQuotedNewlines": True or False, # [Experimental] Whether to allow quoted newlines in the source CSV data.
- "schema": { # [Optional] Schema of the table being written to.
+ "quote": "A String", # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true.
+ "createDisposition": "A String", # [Optional] Specifies whether the job is allowed to create new tables. The following values are supported: CREATE_IF_NEEDED: If the table does not exist, BigQuery creates the table. CREATE_NEVER: The table must already exist. If it does not, a 'notFound' error is returned in the job result. The default value is CREATE_IF_NEEDED. Creation, truncation and append actions occur as one atomic update upon job completion.
+ "schemaInlineFormat": "A String", # [Deprecated] The format of the schemaInline property.
+ "schemaInline": "A String", # [Deprecated] The inline schema. For CSV schemas, specify as "Field1:Type1[,Field2:Type2]*". For example, "foo:STRING, bar:INTEGER, baz:FLOAT".
+ "allowQuotedNewlines": True or False, # Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false.
+ "schema": { # [Optional] The schema for the destination table. The schema can be omitted if the destination table already exists or if the schema can be inferred from the loaded data.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -390,6 +391,7 @@ Args:
},
"priority": "A String", # [Optional] Specifies a priority for the query. Default is INTERACTIVE. Alternative is BATCH.
"writeDisposition": "A String", # [Optional] Whether to overwrite an existing table (WRITE_TRUNCATE), append to an existing table (WRITE_APPEND), or require that the the table is empty (WRITE_EMPTY). Default is WRITE_EMPTY.
+ "allowLargeResults": True or False, # [Experimental] If true, allows >128M results to be materialized in the destination table. Requires destination_table to be set.
"createDisposition": "A String", # [Optional] Whether to create the table if it doesn't already exist (CREATE_IF_NEEDED) or to require the table already exist (CREATE_NEVER). Default is CREATE_IF_NEEDED.
"query": "A String", # [Required] BigQuery SQL query to execute.
"preserveNulls": True or False, # [Experimental] If set, preserve null values in table data, rather than mapping null values to the column's default value. This flag currently defaults to false, but the default will soon be changed to true. Shortly afterward, this flag will be removed completely. Please specify true if possible, and false only if you need to force the old behavior while updating client code.
@@ -472,34 +474,34 @@ Returns:
"etag": "A String", # [Output-only] A hash of this resource.
"configuration": { # [Required] Describes the job configuration.
"load": { # [Pick one] Configures a load job.
- "encoding": "A String", # [Optional] Character encoding of the input data. May be UTF-8 or ISO-8859-1. Default is UTF-8.
- "fieldDelimiter": "A String", # [Optional] Delimiter to use between fields in the import data. Default is ','. Note that delimiters are applied to the raw, binary data before the encoding is applied.
- "sourceFormat": "A String", # [Experimental] Optional and defaults to CSV. Format of source files. For CSV uploads, specify "CSV". For imports of datastore backups, specify "DATASTORE_BACKUP". For imports of newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON".
- "destinationTable": { # [Required] Table being written to.
+ "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties.
+ "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (',').
+ "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". The default value is CSV.
+ "destinationTable": { # [Required] The destination table to load the data into.
"projectId": "A String", # [Required] ID of the project billed for storage of the table.
"tableId": "A String", # [Required] ID of the table.
"datasetId": "A String", # [Required] ID of the dataset containing the table.
},
- "writeDisposition": "A String", # [Optional] Whether to overwrite an existing table (WRITE_TRUNCATE), append to an existing table (WRITE_APPEND), or require that the the table is empty (WRITE_EMPTY). Default is WRITE_APPEND.
- "maxBadRecords": 42, # [Optional] Maximum number of bad records that should be ignored before the entire job is aborted and no updates are performed.
- "skipLeadingRows": 42, # [Optional] Number of rows of initial data to skip in the data being imported.
- "sourceUris": [ # [Required] Source URIs describing Google Cloud Storage locations of data to load.
+ "writeDisposition": "A String", # [Optional] Specifies the action that occurs if the destination table already exists. Each action is atomic and only occurs if BigQuery is able to fully load the data and the load job completes without error. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists, a 'duplicate' error is returned in the job result. Creation, truncation and append actions occur as one atomic update upon job completion.
+ "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an 'invalid' error is returned in the job result and the job fails. The default value is 0, which requires that all records are valid.
+ "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.
+ "sourceUris": [ # [Required] The fully-qualified URIs that point to your data on Google Cloud Storage.
"A String",
],
- "quote": "A String", # [Optional] Quote character to use. Default is '"'. Note that quoting is done on the raw, binary data before the encoding is applied. If no quoting is done, use am empty string.
- "createDisposition": "A String", # [Optional] Whether to create the table if it doesn't already exist (CREATE_IF_NEEDED) or to require the table already exist (CREATE_NEVER). Default is CREATE_IF_NEEDED.
- "schemaInlineFormat": "A String", # [Experimental] Format of inlineSchema field.
- "schemaInline": "A String", # [Experimental] Inline schema. For CSV schemas, specify as "Field1:Type1[,Field2:Type2]*". For example, "foo:STRING, bar:INTEGER, baz:FLOAT"
- "allowQuotedNewlines": True or False, # [Experimental] Whether to allow quoted newlines in the source CSV data.
- "schema": { # [Optional] Schema of the table being written to.
+ "quote": "A String", # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true.
+ "createDisposition": "A String", # [Optional] Specifies whether the job is allowed to create new tables. The following values are supported: CREATE_IF_NEEDED: If the table does not exist, BigQuery creates the table. CREATE_NEVER: The table must already exist. If it does not, a 'notFound' error is returned in the job result. The default value is CREATE_IF_NEEDED. Creation, truncation and append actions occur as one atomic update upon job completion.
+ "schemaInlineFormat": "A String", # [Deprecated] The format of the schemaInline property.
+ "schemaInline": "A String", # [Deprecated] The inline schema. For CSV schemas, specify as "Field1:Type1[,Field2:Type2]*". For example, "foo:STRING, bar:INTEGER, baz:FLOAT".
+ "allowQuotedNewlines": True or False, # Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false.
+ "schema": { # [Optional] The schema for the destination table. The schema can be omitted if the destination table already exists or if the schema can be inferred from the loaded data.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -528,6 +530,7 @@ Returns:
},
"priority": "A String", # [Optional] Specifies a priority for the query. Default is INTERACTIVE. Alternative is BATCH.
"writeDisposition": "A String", # [Optional] Whether to overwrite an existing table (WRITE_TRUNCATE), append to an existing table (WRITE_APPEND), or require that the the table is empty (WRITE_EMPTY). Default is WRITE_EMPTY.
+ "allowLargeResults": True or False, # [Experimental] If true, allows >128M results to be materialized in the destination table. Requires destination_table to be set.
"createDisposition": "A String", # [Optional] Whether to create the table if it doesn't already exist (CREATE_IF_NEEDED) or to require the table already exist (CREATE_NEVER). Default is CREATE_IF_NEEDED.
"query": "A String", # [Required] BigQuery SQL query to execute.
"preserveNulls": True or False, # [Experimental] If set, preserve null values in table data, rather than mapping null values to the column's default value. This flag currently defaults to false, but the default will soon be changed to true. Shortly afterward, this flag will be removed completely. Please specify true if possible, and false only if you need to force the old behavior while updating client code.
@@ -634,34 +637,34 @@ Returns:
"state": "A String", # Running state of the job. When the state is DONE, errorResult can be checked to determine whether the job succeeded or failed.
"configuration": { # [Full-projection-only] Specifies the job configuration.
"load": { # [Pick one] Configures a load job.
- "encoding": "A String", # [Optional] Character encoding of the input data. May be UTF-8 or ISO-8859-1. Default is UTF-8.
- "fieldDelimiter": "A String", # [Optional] Delimiter to use between fields in the import data. Default is ','. Note that delimiters are applied to the raw, binary data before the encoding is applied.
- "sourceFormat": "A String", # [Experimental] Optional and defaults to CSV. Format of source files. For CSV uploads, specify "CSV". For imports of datastore backups, specify "DATASTORE_BACKUP". For imports of newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON".
- "destinationTable": { # [Required] Table being written to.
+ "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties.
+ "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (',').
+ "sourceFormat": "A String", # [Optional] The format of the data files. For CSV files, specify "CSV". For datastore backups, specify "DATASTORE_BACKUP". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". The default value is CSV.
+ "destinationTable": { # [Required] The destination table to load the data into.
"projectId": "A String", # [Required] ID of the project billed for storage of the table.
"tableId": "A String", # [Required] ID of the table.
"datasetId": "A String", # [Required] ID of the dataset containing the table.
},
- "writeDisposition": "A String", # [Optional] Whether to overwrite an existing table (WRITE_TRUNCATE), append to an existing table (WRITE_APPEND), or require that the the table is empty (WRITE_EMPTY). Default is WRITE_APPEND.
- "maxBadRecords": 42, # [Optional] Maximum number of bad records that should be ignored before the entire job is aborted and no updates are performed.
- "skipLeadingRows": 42, # [Optional] Number of rows of initial data to skip in the data being imported.
- "sourceUris": [ # [Required] Source URIs describing Google Cloud Storage locations of data to load.
+ "writeDisposition": "A String", # [Optional] Specifies the action that occurs if the destination table already exists. Each action is atomic and only occurs if BigQuery is able to fully load the data and the load job completes without error. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists, a 'duplicate' error is returned in the job result. Creation, truncation and append actions occur as one atomic update upon job completion.
+ "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an 'invalid' error is returned in the job result and the job fails. The default value is 0, which requires that all records are valid.
+ "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.
+ "sourceUris": [ # [Required] The fully-qualified URIs that point to your data on Google Cloud Storage.
"A String",
],
- "quote": "A String", # [Optional] Quote character to use. Default is '"'. Note that quoting is done on the raw, binary data before the encoding is applied. If no quoting is done, use am empty string.
- "createDisposition": "A String", # [Optional] Whether to create the table if it doesn't already exist (CREATE_IF_NEEDED) or to require the table already exist (CREATE_NEVER). Default is CREATE_IF_NEEDED.
- "schemaInlineFormat": "A String", # [Experimental] Format of inlineSchema field.
- "schemaInline": "A String", # [Experimental] Inline schema. For CSV schemas, specify as "Field1:Type1[,Field2:Type2]*". For example, "foo:STRING, bar:INTEGER, baz:FLOAT"
- "allowQuotedNewlines": True or False, # [Experimental] Whether to allow quoted newlines in the source CSV data.
- "schema": { # [Optional] Schema of the table being written to.
+ "quote": "A String", # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true.
+ "createDisposition": "A String", # [Optional] Specifies whether the job is allowed to create new tables. The following values are supported: CREATE_IF_NEEDED: If the table does not exist, BigQuery creates the table. CREATE_NEVER: The table must already exist. If it does not, a 'notFound' error is returned in the job result. The default value is CREATE_IF_NEEDED. Creation, truncation and append actions occur as one atomic update upon job completion.
+ "schemaInlineFormat": "A String", # [Deprecated] The format of the schemaInline property.
+ "schemaInline": "A String", # [Deprecated] The inline schema. For CSV schemas, specify as "Field1:Type1[,Field2:Type2]*". For example, "foo:STRING, bar:INTEGER, baz:FLOAT".
+ "allowQuotedNewlines": True or False, # Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false.
+ "schema": { # [Optional] The schema for the destination table. The schema can be omitted if the destination table already exists or if the schema can be inferred from the loaded data.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -690,6 +693,7 @@ Returns:
},
"priority": "A String", # [Optional] Specifies a priority for the query. Default is INTERACTIVE. Alternative is BATCH.
"writeDisposition": "A String", # [Optional] Whether to overwrite an existing table (WRITE_TRUNCATE), append to an existing table (WRITE_APPEND), or require that the the table is empty (WRITE_EMPTY). Default is WRITE_EMPTY.
+ "allowLargeResults": True or False, # [Experimental] If true, allows >128M results to be materialized in the destination table. Requires destination_table to be set.
"createDisposition": "A String", # [Optional] Whether to create the table if it doesn't already exist (CREATE_IF_NEEDED) or to require the table already exist (CREATE_NEVER). Default is CREATE_IF_NEEDED.
"query": "A String", # [Required] BigQuery SQL query to execute.
"preserveNulls": True or False, # [Experimental] If set, preserve null values in table data, rather than mapping null values to the column's default value. This flag currently defaults to false, but the default will soon be changed to true. Shortly afterward, this flag will be removed completely. Please specify true if possible, and false only if you need to force the old behavior while updating client code.
@@ -795,12 +799,12 @@ Returns:
"schema": { # The schema of the results. Present only when the query completes successfully.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
diff --git a/docs/dyn/bigquery_v2.tables.html b/docs/dyn/bigquery_v2.tables.html
index 52bd8ed..ac288cc 100644
--- a/docs/dyn/bigquery_v2.tables.html
+++ b/docs/dyn/bigquery_v2.tables.html
@@ -139,12 +139,12 @@ Returns:
"schema": { # [Optional] Describes the schema of this table.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -181,12 +181,12 @@ Args:
"schema": { # [Optional] Describes the schema of this table.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -216,12 +216,12 @@ Returns:
"schema": { # [Optional] Describes the schema of this table.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -306,12 +306,12 @@ Args:
"schema": { # [Optional] Describes the schema of this table.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -341,12 +341,12 @@ Returns:
"schema": { # [Optional] Describes the schema of this table.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -384,12 +384,12 @@ Args:
"schema": { # [Optional] Describes the schema of this table.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
@@ -419,12 +419,12 @@ Returns:
"schema": { # [Optional] Describes the schema of this table.
"fields": [ # Describes the fields in a table.
{
- "fields": [ # [Optional] Describes nested fields when type is RECORD.
+ "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD.
# Object with schema name: TableFieldSchema
],
- "type": "A String", # [Required] Data type of the field.
- "mode": "A String", # [Optional] Mode of the field (whether or not it can be null. Default is NULLABLE.
- "name": "A String", # [Required] Name of the field.
+ "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates a nested schema).
+ "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE.
+ "name": "A String", # [Required] The field name.
},
],
},
diff --git a/docs/dyn/blogger_v3.blogs.html b/docs/dyn/blogger_v3.blogs.html
index 179db95..060c71e 100644
--- a/docs/dyn/blogger_v3.blogs.html
+++ b/docs/dyn/blogger_v3.blogs.html
@@ -78,7 +78,7 @@ h1, h2, h3 {
get(blogId, maxPosts=None)
Gets one blog by id.
+ getByUrl(url)
Retrieve a Blog by URL.
@@ -186,11 +186,11 @@ Returns:
getByUrl(url=None)
+ getByUrl(url)
Retrieve a Blog by URL.
Args:
- url: string, The URL of the blog to retrieve.
+ url: string, The URL of the blog to retrieve. (required)
Returns:
An object of the form:
diff --git a/docs/dyn/blogger_v3.posts.html b/docs/dyn/blogger_v3.posts.html
index 19d99be..631a466 100644
--- a/docs/dyn/blogger_v3.posts.html
+++ b/docs/dyn/blogger_v3.posts.html
@@ -81,7 +81,7 @@ h1, h2, h3 {
get(blogId, postId, maxComments=None)
Get a post by id.
- getByPath(blogId, path=None, maxComments=None)
+ getByPath(blogId, path, maxComments=None)
Retrieve a Post by Path.
@@ -96,7 +96,7 @@ h1, h2, h3 {
patch(blogId, postId, body)
Update a post. This method supports patch semantics.
+ search(blogId, q)
Search for a post.
@@ -189,12 +189,12 @@ Returns:
getByPath(blogId, path=None, maxComments=None)
+ getByPath(blogId, path, maxComments=None)
Retrieve a Post by Path. Args: blogId: string, ID of the blog to fetch the post from. (required) - path: string, Path of the Post to retrieve. + path: string, Path of the Post to retrieve. (required) maxComments: integer, Maximum number of comments to pull back on a post. Returns: @@ -647,12 +647,12 @@ Returns:
search(blogId, q=None)
+ search(blogId, q)
Search for a post.
Args:
blogId: string, ID of the blog to fetch the post from. (required)
- q: string, Query terms to search this blog for matching posts.
+ q: string, Query terms to search this blog for matching posts. (required)
Returns:
An object of the form:
diff --git a/docs/dyn/calendar_v3.calendarList.html b/docs/dyn/calendar_v3.calendarList.html
index 0ab7cf8..4e608df 100644
--- a/docs/dyn/calendar_v3.calendarList.html
+++ b/docs/dyn/calendar_v3.calendarList.html
@@ -130,6 +130,7 @@ Returns:
"description": "A String", # Description of the calendar. Optional. Read-only.
"colorId": "A String", # The color of the calendar. This is an ID referring to an entry in the "calendar" section of the colors definition (see the "colors" endpoint). Optional.
"selected": True or False, # Whether the calendar content shows up in the calendar UI. Optional. The default is False.
+ "primary": True or False, # Whether the calendar is the primary calendar of the authenticated user. Read-only. Optional. The default is False.
"summary": "A String", # Title of the calendar. Read-only.
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the calendar as free-form text. Optional. Read-only.
@@ -169,6 +170,7 @@ Args:
"description": "A String", # Description of the calendar. Optional. Read-only.
"colorId": "A String", # The color of the calendar. This is an ID referring to an entry in the "calendar" section of the colors definition (see the "colors" endpoint). Optional.
"selected": True or False, # Whether the calendar content shows up in the calendar UI. Optional. The default is False.
+ "primary": True or False, # Whether the calendar is the primary calendar of the authenticated user. Read-only. Optional. The default is False.
"summary": "A String", # Title of the calendar. Read-only.
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the calendar as free-form text. Optional. Read-only.
@@ -204,6 +206,7 @@ Returns:
"description": "A String", # Description of the calendar. Optional. Read-only.
"colorId": "A String", # The color of the calendar. This is an ID referring to an entry in the "calendar" section of the colors definition (see the "colors" endpoint). Optional.
"selected": True or False, # Whether the calendar content shows up in the calendar UI. Optional. The default is False.
+ "primary": True or False, # Whether the calendar is the primary calendar of the authenticated user. Read-only. Optional. The default is False.
"summary": "A String", # Title of the calendar. Read-only.
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the calendar as free-form text. Optional. Read-only.
@@ -256,6 +259,7 @@ Returns:
"description": "A String", # Description of the calendar. Optional. Read-only.
"colorId": "A String", # The color of the calendar. This is an ID referring to an entry in the "calendar" section of the colors definition (see the "colors" endpoint). Optional.
"selected": True or False, # Whether the calendar content shows up in the calendar UI. Optional. The default is False.
+ "primary": True or False, # Whether the calendar is the primary calendar of the authenticated user. Read-only. Optional. The default is False.
"summary": "A String", # Title of the calendar. Read-only.
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the calendar as free-form text. Optional. Read-only.
@@ -314,6 +318,7 @@ Args:
"description": "A String", # Description of the calendar. Optional. Read-only.
"colorId": "A String", # The color of the calendar. This is an ID referring to an entry in the "calendar" section of the colors definition (see the "colors" endpoint). Optional.
"selected": True or False, # Whether the calendar content shows up in the calendar UI. Optional. The default is False.
+ "primary": True or False, # Whether the calendar is the primary calendar of the authenticated user. Read-only. Optional. The default is False.
"summary": "A String", # Title of the calendar. Read-only.
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the calendar as free-form text. Optional. Read-only.
@@ -349,6 +354,7 @@ Returns:
"description": "A String", # Description of the calendar. Optional. Read-only.
"colorId": "A String", # The color of the calendar. This is an ID referring to an entry in the "calendar" section of the colors definition (see the "colors" endpoint). Optional.
"selected": True or False, # Whether the calendar content shows up in the calendar UI. Optional. The default is False.
+ "primary": True or False, # Whether the calendar is the primary calendar of the authenticated user. Read-only. Optional. The default is False.
"summary": "A String", # Title of the calendar. Read-only.
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the calendar as free-form text. Optional. Read-only.
@@ -389,6 +395,7 @@ Args:
"description": "A String", # Description of the calendar. Optional. Read-only.
"colorId": "A String", # The color of the calendar. This is an ID referring to an entry in the "calendar" section of the colors definition (see the "colors" endpoint). Optional.
"selected": True or False, # Whether the calendar content shows up in the calendar UI. Optional. The default is False.
+ "primary": True or False, # Whether the calendar is the primary calendar of the authenticated user. Read-only. Optional. The default is False.
"summary": "A String", # Title of the calendar. Read-only.
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the calendar as free-form text. Optional. Read-only.
@@ -424,6 +431,7 @@ Returns:
"description": "A String", # Description of the calendar. Optional. Read-only.
"colorId": "A String", # The color of the calendar. This is an ID referring to an entry in the "calendar" section of the colors definition (see the "colors" endpoint). Optional.
"selected": True or False, # Whether the calendar content shows up in the calendar UI. Optional. The default is False.
+ "primary": True or False, # Whether the calendar is the primary calendar of the authenticated user. Read-only. Optional. The default is False.
"summary": "A String", # Title of the calendar. Read-only.
"etag": "A String", # ETag of the resource.
"location": "A String", # Geographic location of the calendar as free-form text. Optional. Read-only.
diff --git a/docs/dyn/calendar_v3.events.html b/docs/dyn/calendar_v3.events.html
index f96363d..14939a3 100644
--- a/docs/dyn/calendar_v3.events.html
+++ b/docs/dyn/calendar_v3.events.html
@@ -87,7 +87,7 @@ h1, h2, h3 {
insert(calendarId, body, sendNotifications=None, maxAttendees=None)
Creates an event.
+ instances(calendarId, eventId, timeMin=None, showDeleted=None, alwaysIncludeEmail=None, pageToken=None, maxAttendees=None, maxResults=None, timeMax=None, timeZone=None, originalStart=None)
Returns instances of the specified recurring event.
@@ -763,16 +763,16 @@ Returns:
instances(calendarId, eventId, timeMin=None, pageToken=None, alwaysIncludeEmail=None, showDeleted=None, maxAttendees=None, maxResults=None, timeMax=None, timeZone=None, originalStart=None)
+ instances(calendarId, eventId, timeMin=None, showDeleted=None, alwaysIncludeEmail=None, pageToken=None, maxAttendees=None, maxResults=None, timeMax=None, timeZone=None, originalStart=None)
Returns instances of the specified recurring event.
Args:
calendarId: string, Calendar identifier. (required)
eventId: string, Recurring event identifier. (required)
timeMin: string, Lower bound (inclusive) for an event's end time to filter by. Optional. The default is not to filter by end time.
- pageToken: string, Token specifying which result page to return. Optional.
+ showDeleted: boolean, Whether to include deleted events (with 'status' equals 'cancelled') in the result. Cancelled instances of recurring events will still be included if 'singleEvents' is False. Optional. The default is False.
alwaysIncludeEmail: boolean, Whether to always include a value in the "email" field for the organizer, creator and attendees, even if no real email is available (i.e. a generated, non-working value will be provided). The use of this option is discouraged and should only be used by clients which cannot handle the absence of an email address value in the mentioned places. Optional. The default is False.
- showDeleted: boolean, Whether to include deleted events (with 'eventStatus' equals 'cancelled') in the result. Optional. The default is False.
+ pageToken: string, Token specifying which result page to return. Optional.
maxAttendees: integer, The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional.
maxResults: integer, Maximum number of events returned on one result page. Optional.
timeMax: string, Upper bound (exclusive) for an event's start time to filter by. Optional. The default is not to filter by start time.
@@ -958,7 +958,7 @@ Args:
updatedMin: string, Lower bound for an event's last modification time (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by last modification time.
singleEvents: boolean, Whether to expand recurring events into instances and only return single one-off events and instances of recurring events, but not the underlying recurring events themselves. Optional. The default is False.
alwaysIncludeEmail: boolean, Whether to always include a value in the "email" field for the organizer, creator and attendees, even if no real email is available (i.e. a generated, non-working value will be provided). The use of this option is discouraged and should only be used by clients which cannot handle the absence of an email address value in the mentioned places. Optional. The default is False.
- showDeleted: boolean, Whether to include deleted single events (with 'status' equals 'cancelled') in the result. Cancelled instances of recurring events will still be included if 'singleEvents' is False. Optional. The default is False.
+ showDeleted: boolean, Whether to include deleted events (with 'status' equals 'cancelled') in the result. Cancelled instances of recurring events (but not the underlying recurring event) will still be included if 'showDeleted' and 'singleEvents' are both False. If 'showDeleted' and 'singleEvents' are both True only single instances of deleted events (but not the underlying recurring events) are returned. Optional. The default is False.
maxAttendees: integer, The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional.
iCalUID: string, Specifies iCalendar UID (iCalUID) of events to be included in the response. Optional.
maxResults: integer, Maximum number of events returned on one result page. Optional.
diff --git a/docs/dyn/discovery_v1.apis.html b/docs/dyn/discovery_v1.apis.html
index 5635b84..280e348 100644
--- a/docs/dyn/discovery_v1.apis.html
+++ b/docs/dyn/discovery_v1.apis.html
@@ -134,9 +134,7 @@ Returns:
},
},
"supportsMediaUpload": True or False, # Whether this method supports media uploads.
- "request": { # The schema for the request.
- "$ref": "A String", # Schema ID for the request schema.
- },
+ "etagRequired": True or False, # Whether this method requires an ETag to be specified. The ETag is sent as an HTTP If-Match or If-None-Match header.
"mediaUpload": { # Media upload parameters.
"maxSize": "A String", # Maximum size of a media upload, such as "1MB", "2GB" or "3TB".
"protocols": { # Supported upload protocols.
@@ -153,6 +151,9 @@ Returns:
"A String",
],
},
+ "request": { # The schema for the request.
+ "$ref": "A String", # Schema ID for the request schema.
+ },
"response": { # The schema for the response.
"$ref": "A String", # Schema ID for the response schema.
},
@@ -291,9 +292,7 @@ Returns:
},
},
"supportsMediaUpload": True or False, # Whether this method supports media uploads.
- "request": { # The schema for the request.
- "$ref": "A String", # Schema ID for the request schema.
- },
+ "etagRequired": True or False, # Whether this method requires an ETag to be specified. The ETag is sent as an HTTP If-Match or If-None-Match header.
"mediaUpload": { # Media upload parameters.
"maxSize": "A String", # Maximum size of a media upload, such as "1MB", "2GB" or "3TB".
"protocols": { # Supported upload protocols.
@@ -310,6 +309,9 @@ Returns:
"A String",
],
},
+ "request": { # The schema for the request.
+ "$ref": "A String", # Schema ID for the request schema.
+ },
"response": { # The schema for the response.
"$ref": "A String", # Schema ID for the response schema.
},
diff --git a/docs/dyn/drive_v2.about.html b/docs/dyn/drive_v2.about.html
index 09b6d34..24a3664 100644
--- a/docs/dyn/drive_v2.about.html
+++ b/docs/dyn/drive_v2.about.html
@@ -98,14 +98,15 @@ Returns:
"featureRate": 3.14, # The request limit rate for this feature, in queries per second.
},
],
- "quotaBytesUsed": "A String", # The number of quota bytes used.
+ "quotaBytesUsed": "A String", # The number of quota bytes used by Google Drive.
"user": { # The JSON template for a user. # The authenticated user.
"picture": { # The user's profile picture.
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"permissionId": "A String", # The current user's ID as visible in the permissions collection.
"maxUploadSizes": [ # List of max upload sizes for each file type. The most specific type takes precedence.
diff --git a/docs/dyn/drive_v2.apps.html b/docs/dyn/drive_v2.apps.html
index 27f5594..d8dfd75 100644
--- a/docs/dyn/drive_v2.apps.html
+++ b/docs/dyn/drive_v2.apps.html
@@ -79,7 +79,7 @@ h1, h2, h3 {
Gets a specific app.
-Lists a user's apps.
+Lists a user's installed apps.
Method Details
get(appId)
@@ -91,7 +91,7 @@ Args:
Returns:
An object of the form:
- { # Information about a third-party application which the user has installed or given access to Google Drive.
+ { # The apps resource provides a list of the apps that a user has installed, with information about each app's supported MIME types, file extensions, and other details.
"kind": "drive#app", # This is always drive#app.
"primaryFileExtensions": [ # The list of primary file extensions.
"A String",
@@ -129,7 +129,7 @@ Returns:
list()
- Lists a user's apps.
+ Lists a user's installed apps.
Args:
@@ -138,7 +138,7 @@ Returns:
{ # A list of third-party applications which the user has installed or given access to Google Drive.
"items": [ # The actual list of apps.
- { # Information about a third-party application which the user has installed or given access to Google Drive.
+ { # The apps resource provides a list of the apps that a user has installed, with information about each app's supported MIME types, file extensions, and other details.
"kind": "drive#app", # This is always drive#app.
"primaryFileExtensions": [ # The list of primary file extensions.
"A String",
diff --git a/docs/dyn/drive_v2.changes.html b/docs/dyn/drive_v2.changes.html
index 416526e..505e7af 100644
--- a/docs/dyn/drive_v2.changes.html
+++ b/docs/dyn/drive_v2.changes.html
@@ -99,7 +99,6 @@ Returns:
"deleted": True or False, # Whether the file has been deleted.
"file": { # The metadata for a file. # The updated state of the file. Present if the file has not been deleted.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -109,13 +108,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -147,9 +166,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -181,8 +200,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -205,7 +224,7 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
},
@@ -238,7 +257,6 @@ Returns:
"deleted": True or False, # Whether the file has been deleted.
"file": { # The metadata for a file. # The updated state of the file. Present if the file has not been deleted.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -248,13 +266,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -286,9 +324,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -320,8 +358,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -344,7 +382,7 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
},
diff --git a/docs/dyn/drive_v2.children.html b/docs/dyn/drive_v2.children.html
index 188f97d..6babcde 100644
--- a/docs/dyn/drive_v2.children.html
+++ b/docs/dyn/drive_v2.children.html
@@ -111,7 +111,7 @@ Args:
Returns:
An object of the form:
- { # A reference to a file's child.
+ { # A reference to a folder's child.
"kind": "drive#childReference", # This is always drive#childReference.
"childLink": "A String", # A link to the child.
"id": "A String", # The ID of the child.
@@ -128,7 +128,7 @@ Args:
body: object, The request body. (required)
The object takes the form of:
-{ # A reference to a file's child.
+{ # A reference to a folder's child.
"kind": "drive#childReference", # This is always drive#childReference.
"childLink": "A String", # A link to the child.
"id": "A String", # The ID of the child.
@@ -139,7 +139,7 @@ Args:
Returns:
An object of the form:
- { # A reference to a file's child.
+ { # A reference to a folder's child.
"kind": "drive#childReference", # This is always drive#childReference.
"childLink": "A String", # A link to the child.
"id": "A String", # The ID of the child.
@@ -164,7 +164,7 @@ Returns:
"nextPageToken": "A String", # The page token for the next page of children.
"kind": "drive#childList", # This is always drive#childList.
"items": [ # The actual list of children.
- { # A reference to a file's child.
+ { # A reference to a folder's child.
"kind": "drive#childReference", # This is always drive#childReference.
"childLink": "A String", # A link to the child.
"id": "A String", # The ID of the child.
diff --git a/docs/dyn/drive_v2.comments.html b/docs/dyn/drive_v2.comments.html
index 945d2c4..da882e7 100644
--- a/docs/dyn/drive_v2.comments.html
+++ b/docs/dyn/drive_v2.comments.html
@@ -129,8 +129,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this comment has been deleted. If a comment has been deleted the content will be cleared and this will only represent a comment that once existed.
"replies": [ # Replies to this post.
@@ -141,8 +142,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -190,8 +192,9 @@ Args:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this comment has been deleted. If a comment has been deleted the content will be cleared and this will only represent a comment that once existed.
"replies": [ # Replies to this post.
@@ -202,8 +205,9 @@ Args:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -245,8 +249,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this comment has been deleted. If a comment has been deleted the content will be cleared and this will only represent a comment that once existed.
"replies": [ # Replies to this post.
@@ -257,8 +262,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -314,8 +320,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this comment has been deleted. If a comment has been deleted the content will be cleared and this will only represent a comment that once existed.
"replies": [ # Replies to this post.
@@ -326,8 +333,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -393,8 +401,9 @@ Args:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this comment has been deleted. If a comment has been deleted the content will be cleared and this will only represent a comment that once existed.
"replies": [ # Replies to this post.
@@ -405,8 +414,9 @@ Args:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -448,8 +458,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this comment has been deleted. If a comment has been deleted the content will be cleared and this will only represent a comment that once existed.
"replies": [ # Replies to this post.
@@ -460,8 +471,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -510,8 +522,9 @@ Args:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this comment has been deleted. If a comment has been deleted the content will be cleared and this will only represent a comment that once existed.
"replies": [ # Replies to this post.
@@ -522,8 +535,9 @@ Args:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -565,8 +579,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this comment has been deleted. If a comment has been deleted the content will be cleared and this will only represent a comment that once existed.
"replies": [ # Replies to this post.
@@ -577,8 +592,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
diff --git a/docs/dyn/drive_v2.files.html b/docs/dyn/drive_v2.files.html
index 87cbc06..407b827 100644
--- a/docs/dyn/drive_v2.files.html
+++ b/docs/dyn/drive_v2.files.html
@@ -84,7 +84,7 @@ h1, h2, h3 {
get(fileId, projection=None, updateViewedDate=None)
Gets a file's metadata by ID.
+ insert(body=None, media_body=None, convert=None, useContentAsIndexableText=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None, pinned=None)
Insert a new file.
list(q=None, projection=None, pageToken=None, maxResults=None)
@@ -93,7 +93,7 @@ h1, h2, h3 {
list_next(previous_request, previous_response)
Retrieves the next page of results.
+ patch(fileId, body, newRevision=None, pinned=None, ocrLanguage=None, ocr=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)
Updates file metadata and/or content. This method supports patch semantics.
@@ -105,8 +105,8 @@ h1, h2, h3 {
untrash(fileId)
Restores a file from the trash.
-Updates file metadata and/or content
+ update(fileId, body=None, newRevision=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)
+Updates file metadata and/or content.
Method Details
copy(fileId, body, pinned=None, convert=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None)
@@ -119,7 +119,6 @@ Args:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -129,13 +128,33 @@ Args:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -167,9 +186,9 @@ Args:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -201,8 +220,8 @@ Args:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -225,7 +244,7 @@ Args:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
@@ -242,7 +261,6 @@ Returns:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -252,13 +270,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -290,9 +328,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -324,8 +362,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -348,7 +386,7 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
@@ -380,7 +418,6 @@ Returns:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -390,13 +427,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -428,9 +485,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -462,8 +519,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -486,14 +543,14 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
- insert(body=None, media_body=None, convert=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None, pinned=None)
+ insert(body=None, media_body=None, convert=None, useContentAsIndexableText=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None, pinned=None)
Insert a new file.
Args:
@@ -502,7 +559,6 @@ Args:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -512,13 +568,33 @@ Args:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -550,9 +626,9 @@ Args:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -584,8 +660,8 @@ Args:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -608,13 +684,14 @@ Args:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
convert: boolean, Whether to convert this file to the corresponding Google Docs format.
+ useContentAsIndexableText: boolean, Whether to use the content as indexable text.
ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
timedTextLanguage: string, The language of the timed text.
@@ -626,7 +703,6 @@ Returns:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -636,13 +712,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -674,9 +770,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -708,8 +804,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -732,7 +828,7 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
@@ -760,7 +856,6 @@ Returns:
"items": [ # The actual list of files.
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -770,13 +865,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -808,9 +923,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -842,8 +957,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -866,7 +981,7 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
},
@@ -892,7 +1007,7 @@ Returns:
- patch(fileId, body, newRevision=None, pinned=None, ocrLanguage=None, ocr=None, updateViewedDate=None, timedTextTrackName=None, convert=None, setModifiedDate=None, timedTextLanguage=None)
+ patch(fileId, body, newRevision=None, pinned=None, ocrLanguage=None, ocr=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)
Updates file metadata and/or content. This method supports patch semantics.
Args:
@@ -902,7 +1017,6 @@ Args:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -912,13 +1026,33 @@ Args:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -950,9 +1084,9 @@ Args:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -984,8 +1118,8 @@ Args:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -1008,18 +1142,19 @@ Args:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
- newRevision: boolean, Whether a blob upload should create a new revision. If false, the blob data in the current head revision will be replaced.
+ newRevision: boolean, Whether a blob upload should create a new revision. If not set or false, the blob data in the current head revision is replaced. If true, a new blob is created as head revision, and previous revisions are preserved (causing increased use of the user's data storage quota).
pinned: boolean, Whether to pin the new revision.
ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
updateViewedDate: boolean, Whether to update the view date after successfully updating the file.
timedTextTrackName: string, The timed text track name.
convert: boolean, Whether to convert this file to the corresponding Google Docs format.
+ useContentAsIndexableText: boolean, Whether to use the content as indexable text.
setModifiedDate: boolean, Whether to set the modified date with the supplied modified date.
timedTextLanguage: string, The language of the timed text.
@@ -1028,7 +1163,6 @@ Returns:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -1038,13 +1172,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -1076,9 +1230,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -1110,8 +1264,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -1134,7 +1288,7 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
@@ -1152,7 +1306,6 @@ Returns:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -1162,13 +1315,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -1200,9 +1373,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -1234,8 +1407,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -1258,7 +1431,7 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
@@ -1276,7 +1449,6 @@ Returns:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -1286,13 +1458,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -1324,9 +1516,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -1358,8 +1550,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -1382,7 +1574,7 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
@@ -1400,7 +1592,6 @@ Returns:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -1410,13 +1601,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -1448,9 +1659,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -1482,8 +1693,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -1506,15 +1717,15 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
- update(fileId, body=None, newRevision=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, updateViewedDate=None, timedTextTrackName=None, convert=None, setModifiedDate=None, timedTextLanguage=None)
- Updates file metadata and/or content
+ update(fileId, body=None, newRevision=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)
+ Updates file metadata and/or content.
Args:
fileId: string, The ID of the file to update. (required)
@@ -1523,7 +1734,6 @@ Args:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -1533,13 +1743,33 @@ Args:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -1571,9 +1801,9 @@ Args:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -1605,8 +1835,8 @@ Args:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -1629,12 +1859,12 @@ Args:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
- newRevision: boolean, Whether a blob upload should create a new revision. If false, the blob data in the current head revision will be replaced.
+ newRevision: boolean, Whether a blob upload should create a new revision. If not set or false, the blob data in the current head revision is replaced. If true, a new blob is created as head revision, and previous revisions are preserved (causing increased use of the user's data storage quota).
media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
@@ -1642,6 +1872,7 @@ Args:
updateViewedDate: boolean, Whether to update the view date after successfully updating the file.
timedTextTrackName: string, The timed text track name.
convert: boolean, Whether to convert this file to the corresponding Google Docs format.
+ useContentAsIndexableText: boolean, Whether to use the content as indexable text.
setModifiedDate: boolean, Whether to set the modified date with the supplied modified date.
timedTextLanguage: string, The language of the timed text.
@@ -1650,7 +1881,6 @@ Returns:
{ # The metadata for a file.
"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
- "appDataContents": True or False, # Whether this file is in the appdata folder.
"thumbnailLink": "A String", # A link to the file's thumbnail.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
@@ -1660,13 +1890,33 @@ Returns:
"trashed": True or False, # Whether this file has been trashed.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
- "text": "A String", # The text to be indexed for this file
+ "text": "A String", # The text to be indexed for this file.
},
"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
"etag": "A String", # ETag of the file.
- "lastModifyingUserName": "A String", # Name of the last user to modify this file. This will only be populated if a user has edited this file.
+ "lastModifyingUserName": "A String", # Name of the last user to modify this file.
"writersCanShare": True or False, # Whether writers can share the document with other users.
- "id": "A String", # The id of the file.
+ "owners": [ # The owner(s) of this file.
+ { # The JSON template for a user.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
+ ],
+ "id": "A String", # The ID of the file.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"title": "A String", # The title of this file.
"ownerNames": [ # Name(s) of the owner(s) of this file.
"A String",
@@ -1698,9 +1948,9 @@ Returns:
"editable": True or False, # Whether the file can be edited by the current user.
"kind": "drive#file", # The type of file. This is always drive#file.
"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
- "fileSize": "A String", # The size of the file in bytes. This will only be populated on files with content stored in Drive.
+ "fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
- "md5Checksum": "A String", # An MD5 checksum for the content of this file. This will only be populated on files with content stored in Drive.
+ "md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
"iconLink": "A String", # A link to the file's icon.
"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
@@ -1732,8 +1982,8 @@ Returns:
"embedLink": "A String", # A link for embedding the file.
"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
- "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
- "userPermission": { # A single permission for a file.
+ "downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
+ "userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -1756,7 +2006,7 @@ Returns:
],
"selfLink": "A String", # A link back to this permission.
},
- "fileExtension": "A String", # The file extension used when downloading this file. This field is set from the title when inserting or uploading new content. This will only be populated on files with content stored in Drive.
+ "fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"selfLink": "A String", # A link back to this file.
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
diff --git a/docs/dyn/drive_v2.permissions.html b/docs/dyn/drive_v2.permissions.html
index 09e2e46..4f3048a 100644
--- a/docs/dyn/drive_v2.permissions.html
+++ b/docs/dyn/drive_v2.permissions.html
@@ -81,7 +81,7 @@ h1, h2, h3 {
get(fileId, permissionId)
Gets a permission by ID.
- insert(fileId, body, sendNotificationEmails=None)
+ insert(fileId, body, sendNotificationEmails=None, emailMessage=None)
Inserts a permission for a file.
@@ -114,7 +114,7 @@ Args:
Returns:
An object of the form:
- { # A single permission for a file.
+ { # A permission for a file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -140,7 +140,7 @@ Returns:
- insert(fileId, body, sendNotificationEmails=None)
+ insert(fileId, body, sendNotificationEmails=None, emailMessage=None)
Inserts a permission for a file.
Args:
@@ -148,7 +148,7 @@ Args:
body: object, The request body. (required)
The object takes the form of:
-{ # A single permission for a file.
+{ # A permission for a file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -172,12 +172,13 @@ Args:
"selfLink": "A String", # A link back to this permission.
}
- sendNotificationEmails: boolean, Whether to send notification emails.
+ sendNotificationEmails: boolean, Whether to send notification emails when sharing to users or groups.
+ emailMessage: string, A custom message to include in notification emails.
Returns:
An object of the form:
- { # A single permission for a file.
+ { # A permission for a file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -214,7 +215,7 @@ Returns:
{ # A list of permissions associated with a file.
"items": [ # The actual list of permissions.
- { # A single permission for a file.
+ { # A permission for a file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -254,7 +255,7 @@ Args:
body: object, The request body. (required)
The object takes the form of:
-{ # A single permission for a file.
+{ # A permission for a file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -282,7 +283,7 @@ Args:
Returns:
An object of the form:
- { # A single permission for a file.
+ { # A permission for a file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -317,7 +318,7 @@ Args:
body: object, The request body. (required)
The object takes the form of:
-{ # A single permission for a file.
+{ # A permission for a file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
@@ -345,7 +346,7 @@ Args:
Returns:
An object of the form:
- { # A single permission for a file.
+ { # A permission for a file.
"withLink": True or False, # Whether the link is required for this permission.
"kind": "drive#permission", # This is always drive#permission.
"name": "A String", # The name for this permission.
diff --git a/docs/dyn/drive_v2.replies.html b/docs/dyn/drive_v2.replies.html
index 582221a..1111a4a 100644
--- a/docs/dyn/drive_v2.replies.html
+++ b/docs/dyn/drive_v2.replies.html
@@ -127,8 +127,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -159,8 +160,9 @@ Args:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -184,8 +186,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -223,8 +226,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -273,8 +277,9 @@ Args:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -298,8 +303,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -331,8 +337,9 @@ Args:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
@@ -356,8 +363,9 @@ Returns:
"url": "A String", # A URL that points to a profile picture of this user.
},
"kind": "drive#user", # This is always drive#user.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user of which the request was made on behalf.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
"displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
},
"deleted": True or False, # Whether this reply has been deleted. If a reply has been deleted the content will be cleared and this will only represent a reply that once existed.
"htmlContent": "A String", # HTML formatted content for this reply.
diff --git a/docs/dyn/drive_v2.revisions.html b/docs/dyn/drive_v2.revisions.html
index e7b12a9..1d9645d 100644
--- a/docs/dyn/drive_v2.revisions.html
+++ b/docs/dyn/drive_v2.revisions.html
@@ -111,12 +111,21 @@ Args:
Returns:
An object of the form:
- { # A single revision of a file.
+ { # A revision of a file.
"mimeType": "A String", # The MIME type of the revision.
"pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive which are not Google Docs. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter.
"kind": "drive#revision", # This is always drive#revision.
"publishedLink": "A String", # A link to the published revision.
"publishedOutsideDomain": True or False, # Whether this revision is published outside the domain. This is only populated and can only be modified for Google Docs.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this revision.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"publishAuto": True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Google Docs.
"published": True or False, # Whether this revision is published. This is only populated and can only be modified for Google Docs.
"downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
@@ -146,12 +155,21 @@ Returns:
{ # A list of revisions of a file.
"items": [ # The actual list of revisions.
- { # A single revision of a file.
+ { # A revision of a file.
"mimeType": "A String", # The MIME type of the revision.
"pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive which are not Google Docs. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter.
"kind": "drive#revision", # This is always drive#revision.
"publishedLink": "A String", # A link to the published revision.
"publishedOutsideDomain": True or False, # Whether this revision is published outside the domain. This is only populated and can only be modified for Google Docs.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this revision.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"publishAuto": True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Google Docs.
"published": True or False, # Whether this revision is published. This is only populated and can only be modified for Google Docs.
"downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
@@ -184,12 +202,21 @@ Args:
body: object, The request body. (required)
The object takes the form of:
-{ # A single revision of a file.
+{ # A revision of a file.
"mimeType": "A String", # The MIME type of the revision.
"pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive which are not Google Docs. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter.
"kind": "drive#revision", # This is always drive#revision.
"publishedLink": "A String", # A link to the published revision.
"publishedOutsideDomain": True or False, # Whether this revision is published outside the domain. This is only populated and can only be modified for Google Docs.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this revision.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"publishAuto": True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Google Docs.
"published": True or False, # Whether this revision is published. This is only populated and can only be modified for Google Docs.
"downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
@@ -210,12 +237,21 @@ Args:
Returns:
An object of the form:
- { # A single revision of a file.
+ { # A revision of a file.
"mimeType": "A String", # The MIME type of the revision.
"pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive which are not Google Docs. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter.
"kind": "drive#revision", # This is always drive#revision.
"publishedLink": "A String", # A link to the published revision.
"publishedOutsideDomain": True or False, # Whether this revision is published outside the domain. This is only populated and can only be modified for Google Docs.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this revision.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"publishAuto": True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Google Docs.
"published": True or False, # Whether this revision is published. This is only populated and can only be modified for Google Docs.
"downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
@@ -243,12 +279,21 @@ Args:
body: object, The request body. (required)
The object takes the form of:
-{ # A single revision of a file.
+{ # A revision of a file.
"mimeType": "A String", # The MIME type of the revision.
"pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive which are not Google Docs. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter.
"kind": "drive#revision", # This is always drive#revision.
"publishedLink": "A String", # A link to the published revision.
"publishedOutsideDomain": True or False, # Whether this revision is published outside the domain. This is only populated and can only be modified for Google Docs.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this revision.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"publishAuto": True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Google Docs.
"published": True or False, # Whether this revision is published. This is only populated and can only be modified for Google Docs.
"downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
@@ -269,12 +314,21 @@ Args:
Returns:
An object of the form:
- { # A single revision of a file.
+ { # A revision of a file.
"mimeType": "A String", # The MIME type of the revision.
"pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive which are not Google Docs. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter.
"kind": "drive#revision", # This is always drive#revision.
"publishedLink": "A String", # A link to the published revision.
"publishedOutsideDomain": True or False, # Whether this revision is published outside the domain. This is only populated and can only be modified for Google Docs.
+ "lastModifyingUser": { # The JSON template for a user. # The last user to modify this revision.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
+ },
+ "kind": "drive#user", # This is always drive#user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ },
"publishAuto": True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Google Docs.
"published": True or False, # Whether this revision is published. This is only populated and can only be modified for Google Docs.
"downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
diff --git a/docs/dyn/gan_v1beta1.advertisers.html b/docs/dyn/gan_v1beta1.advertisers.html
index 3c3335c..0ff960c 100644
--- a/docs/dyn/gan_v1beta1.advertisers.html
+++ b/docs/dyn/gan_v1beta1.advertisers.html
@@ -78,7 +78,7 @@ h1, h2, h3 {
get(role, roleId, advertiserId=None)
Retrieves data about a single advertiser if that the requesting advertiser/publisher has access to it. Only publishers can lookup advertisers. Advertisers can request information about themselves by omitting the advertiserId query parameter.
+ list(role, roleId, relationshipStatus=None, pageToken=None, minNinetyDayEpc=None, advertiserCategory=None, maxResults=None, minSevenDayEpc=None, minPayoutRank=None)
Retrieves data about all advertisers that the requesting advertiser/publisher has access to.
@@ -135,7 +135,7 @@ Returns:
- list(role, roleId, relationshipStatus=None, pageToken=None, advertiserCategory=None, minNinetyDayEpc=None, maxResults=None, minSevenDayEpc=None, minPayoutRank=None)
+ list(role, roleId, relationshipStatus=None, pageToken=None, minNinetyDayEpc=None, advertiserCategory=None, maxResults=None, minSevenDayEpc=None, minPayoutRank=None)
Retrieves data about all advertisers that the requesting advertiser/publisher has access to.
Args:
@@ -152,8 +152,8 @@ Args:
declined - An advertiser that did not approve your application.
pending - An advertiser program that you've already applied to, but they haven't yet decided to approve or decline your application.
pageToken: string, The value of 'nextPageToken' from the previous page. Optional.
- advertiserCategory: string, Caret(^) delimted list of advertiser categories. Valid categories are defined here: http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&answer=107581. Filters out all advertisers not in one of the given advertiser categories. Optional.
minNinetyDayEpc: number, Filters out all advertisers that have a ninety day EPC average lower than the given value (inclusive). Min value: 0.0. Optional.
+ advertiserCategory: string, Caret(^) delimted list of advertiser categories. Valid categories are defined here: http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&answer=107581. Filters out all advertisers not in one of the given advertiser categories. Optional.
maxResults: integer, Max number of items to return in this page. Optional. Defaults to 20.
minSevenDayEpc: number, Filters out all advertisers that have a seven day EPC average lower than the given value (inclusive). Min value: 0.0. Optional.
minPayoutRank: integer, A value between 1 and 4, where 1 represents the quartile of advertisers with the lowest ranks and 4 represents the quartile of advertisers with the highest ranks. Filters out all advertisers with a lower rank than the given quartile. For example if a 2 was given only advertisers with a payout rank of 25 or higher would be included. Optional.
diff --git a/docs/dyn/gan_v1beta1.html b/docs/dyn/gan_v1beta1.html
index 4de2571..10402cc 100644
--- a/docs/dyn/gan_v1beta1.html
+++ b/docs/dyn/gan_v1beta1.html
@@ -99,4 +99,9 @@ h1, h2, h3 {
Returns the publishers Resource.
+
+ reports()
+
+Returns the reports Resource.
+