Skip to content

Commit

Permalink
feat(firestore): update the api
Browse files Browse the repository at this point in the history
#### firestore:v1

The following keys were deleted:
- schemas.GoogleFirestoreAdminV1ExportDocumentsRequest.properties.namespaceIds (Total Keys: 2)
- schemas.GoogleFirestoreAdminV1ImportDocumentsRequest.properties.namespaceIds (Total Keys: 2)

The following keys were added:
- resources.projects.resources.databases.methods.delete (Total Keys: 15)
  • Loading branch information
yoshi-automation committed Dec 20, 2022
1 parent 30f2921 commit 89b34a9
Show file tree
Hide file tree
Showing 6 changed files with 147 additions and 85 deletions.
32 changes: 16 additions & 16 deletions docs/dyn/firestore_v1.projects.databases.documents.html
Expand Up @@ -990,14 +990,14 @@ <h3>Method Details</h3>

Args:
parent: string, Required. The parent resource name. In the format: `projects/{project_id}/databases/{database_id}/documents` or `projects/{project_id}/databases/{database_id}/documents/{document_path}`. For example: `projects/my-project/databases/my-database/documents` or `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom` (required)
collectionId: string, Required. The collection ID, relative to `parent`, to list. For example: `chatrooms` or `messages`. (required)
collectionId: string, Optional. The collection ID, relative to `parent`, to list. For example: `chatrooms` or `messages`. This is optional, and when not provided, Firestore will list documents from all collections under the provided `parent`. (required)
mask_fieldPaths: string, The list of field paths in the mask. See Document.fields for a field path syntax reference. (repeated)
orderBy: string, The order to sort results by. For example: `priority desc, name`.
pageSize: integer, The maximum number of documents to return.
pageToken: string, The `next_page_token` value returned from a previous List request, if any.
readTime: string, Reads documents as they were at the given time. This may not be older than 270 seconds.
showMissing: boolean, If the list should show missing documents. A missing document is a document that does not exist but has sub-documents. These documents will be returned with a key but will not have fields, Document.create_time, or Document.update_time set. Requests with `show_missing` may not specify `where` or `order_by`.
transaction: string, Reads documents in a transaction.
orderBy: string, Optional. The optional ordering of the documents to return. For example: `priority desc, __name__ desc`. This mirrors the `ORDER BY` used in Firestore queries but in a string representation. When absent, documents are ordered based on `__name__ ASC`.
pageSize: integer, Optional. The maximum number of documents to return in a single response. Firestore may return fewer than this value.
pageToken: string, Optional. A page token, received from a previous `ListDocuments` response. Provide this to retrieve the subsequent page. When paginating, all other parameters (with the exception of `page_size`) must match the values set in the request that generated the page token.
readTime: string, Perform the read at the provided time. This may not be older than 270 seconds.
showMissing: boolean, If the list should show missing documents. A document is missing if it does not exist, but there are sub-documents nested underneath it. When true, such missing documents will be returned with a key but will not have fields, `create_time`, or `update_time` set. Requests with `show_missing` may not specify `where` or `order_by`.
transaction: string, Perform the read as part of an already active transaction.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
Expand Down Expand Up @@ -1040,7 +1040,7 @@ <h3>Method Details</h3>
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time at which the document was last changed. This value is initially set to the `create_time` then increases monotonically with each change to the document. It can also be compared to values from other documents and the `read_time` of a query.
},
],
&quot;nextPageToken&quot;: &quot;A String&quot;, # The next page token.
&quot;nextPageToken&quot;: &quot;A String&quot;, # A token to retrieve the next page of documents. If this field is omitted, there are no subsequent pages.
}</pre>
</div>

Expand Down Expand Up @@ -1095,14 +1095,14 @@ <h3>Method Details</h3>

Args:
parent: string, Required. The parent resource name. In the format: `projects/{project_id}/databases/{database_id}/documents` or `projects/{project_id}/databases/{database_id}/documents/{document_path}`. For example: `projects/my-project/databases/my-database/documents` or `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom` (required)
collectionId: string, Required. The collection ID, relative to `parent`, to list. For example: `chatrooms` or `messages`. (required)
collectionId: string, Optional. The collection ID, relative to `parent`, to list. For example: `chatrooms` or `messages`. This is optional, and when not provided, Firestore will list documents from all collections under the provided `parent`. (required)
mask_fieldPaths: string, The list of field paths in the mask. See Document.fields for a field path syntax reference. (repeated)
orderBy: string, The order to sort results by. For example: `priority desc, name`.
pageSize: integer, The maximum number of documents to return.
pageToken: string, The `next_page_token` value returned from a previous List request, if any.
readTime: string, Reads documents as they were at the given time. This may not be older than 270 seconds.
showMissing: boolean, If the list should show missing documents. A missing document is a document that does not exist but has sub-documents. These documents will be returned with a key but will not have fields, Document.create_time, or Document.update_time set. Requests with `show_missing` may not specify `where` or `order_by`.
transaction: string, Reads documents in a transaction.
orderBy: string, Optional. The optional ordering of the documents to return. For example: `priority desc, __name__ desc`. This mirrors the `ORDER BY` used in Firestore queries but in a string representation. When absent, documents are ordered based on `__name__ ASC`.
pageSize: integer, Optional. The maximum number of documents to return in a single response. Firestore may return fewer than this value.
pageToken: string, Optional. A page token, received from a previous `ListDocuments` response. Provide this to retrieve the subsequent page. When paginating, all other parameters (with the exception of `page_size`) must match the values set in the request that generated the page token.
readTime: string, Perform the read at the provided time. This may not be older than 270 seconds.
showMissing: boolean, If the list should show missing documents. A document is missing if it does not exist, but there are sub-documents nested underneath it. When true, such missing documents will be returned with a key but will not have fields, `create_time`, or `update_time` set. Requests with `show_missing` may not specify `where` or `order_by`.
transaction: string, Perform the read as part of an already active transaction.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
Expand Down Expand Up @@ -1145,7 +1145,7 @@ <h3>Method Details</h3>
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time at which the document was last changed. This value is initially set to the `create_time` then increases monotonically with each change to the document. It can also be compared to values from other documents and the `read_time` of a query.
},
],
&quot;nextPageToken&quot;: &quot;A String&quot;, # The next page token.
&quot;nextPageToken&quot;: &quot;A String&quot;, # A token to retrieve the next page of documents. If this field is omitted, there are no subsequent pages.
}</pre>
</div>

Expand Down
47 changes: 41 additions & 6 deletions docs/dyn/firestore_v1.projects.databases.html
Expand Up @@ -95,6 +95,9 @@ <h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#create">create(parent, body=None, databaseId=None, x__xgafv=None)</a></code></p>
<p class="firstline">Create a database.</p>
<p class="toc_element">
<code><a href="#delete">delete(name, allowMissing=None, etag=None, validateOnly=None, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes a database.</p>
<p class="toc_element">
<code><a href="#exportDocuments">exportDocuments(name, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Exports a copy of all or a subset of documents from Google Cloud Firestore to another storage system, such as Google Cloud Storage. Recent updates to documents may not be reflected in the export. The export occurs in the background and its progress can be monitored and managed via the Operation resource that is created. The output of an export may only be used once the associated operation is done. If an export operation is cancelled before completion it may leave partial data behind in Google Cloud Storage. For more details on export behavior and output format, refer to: https://cloud.google.com/firestore/docs/manage-data/export-import</p>
Expand Down Expand Up @@ -165,6 +168,44 @@ <h3>Method Details</h3>
}</pre>
</div>

<div class="method">
<code class="details" id="delete">delete(name, allowMissing=None, etag=None, validateOnly=None, x__xgafv=None)</code>
<pre>Deletes a database.

Args:
name: string, Required. A name of the form `projects/{project_id}/databases/{database_id}` (required)
allowMissing: boolean, If set to true and the Database is not found, the request will succeed but no action will be taken.
etag: string, The current etag of the Database. If an etag is provided and does not match the current etag of the database, deletion will be blocked and a FAILED_PRECONDITION error will be returned.
validateOnly: boolean, If set, validate the request and preview the response, but do not actually delete the database.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format

Returns:
An object of the form:

{ # This resource represents a long-running operation that is the result of a network API call.
&quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
&quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
&quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
&quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
},
],
&quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
},
&quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
},
&quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
&quot;response&quot;: { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
},
}</pre>
</div>

<div class="method">
<code class="details" id="exportDocuments">exportDocuments(name, body=None, x__xgafv=None)</code>
<pre>Exports a copy of all or a subset of documents from Google Cloud Firestore to another storage system, such as Google Cloud Storage. Recent updates to documents may not be reflected in the export. The export occurs in the background and its progress can be monitored and managed via the Operation resource that is created. The output of an export may only be used once the associated operation is done. If an export operation is cancelled before completion it may leave partial data behind in Google Cloud Storage. For more details on export behavior and output format, refer to: https://cloud.google.com/firestore/docs/manage-data/export-import
Expand All @@ -178,9 +219,6 @@ <h3>Method Details</h3>
&quot;collectionIds&quot;: [ # Which collection ids to export. Unspecified means all collections.
&quot;A String&quot;,
],
&quot;namespaceIds&quot;: [ # An empty list represents all namespaces. This is the preferred usage for databases that don&#x27;t use namespaces. An empty string element represents the default namespace. This should be used if the database has data in non-default namespaces, but doesn&#x27;t want to include them. Each namespace in this list must be unique.
&quot;A String&quot;,
],
&quot;outputUriPrefix&quot;: &quot;A String&quot;, # The output URI. Currently only supports Google Cloud Storage URIs of the form: `gs://BUCKET_NAME[/NAMESPACE_PATH]`, where `BUCKET_NAME` is the name of the Google Cloud Storage bucket and `NAMESPACE_PATH` is an optional Google Cloud Storage namespace path. When choosing a name, be sure to consider Google Cloud Storage naming guidelines: https://cloud.google.com/storage/docs/naming. If the URI is a bucket (without a namespace path), a prefix will be generated based on the start time.
}

Expand Down Expand Up @@ -252,9 +290,6 @@ <h3>Method Details</h3>
&quot;A String&quot;,
],
&quot;inputUriPrefix&quot;: &quot;A String&quot;, # Location of the exported files. This must match the output_uri_prefix of an ExportDocumentsResponse from an export that has completed successfully. See: google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix.
&quot;namespaceIds&quot;: [ # An empty list represents all namespaces. This is the preferred usage for databases that don&#x27;t use namespaces. An empty string element represents the default namespace. This should be used if the database has data in non-default namespaces, but doesn&#x27;t want to include them. Each namespace in this list must be unique.
&quot;A String&quot;,
],
}

x__xgafv: string, V1 error format.
Expand Down

0 comments on commit 89b34a9

Please sign in to comment.