{ "opencollection": "1.0.0", "info": { "name": "Google Cloud Storage JSON BucketAccessControls Objects API", "version": "v1" }, "request": { "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.google.com/o/oauth2/v2/auth", "accessTokenUrl": "https://oauth2.googleapis.com/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "items": [ { "info": { "name": "Objects", "type": "folder" }, "items": [ { "info": { "name": "Google Cloud Storage List Objects", "type": "http" }, "http": { "method": "GET", "url": "https://storage.googleapis.com/storage/v1/b/:bucket/o", "params": [ { "name": "bucket", "value": "my-bucket", "type": "path", "description": "Name of the bucket. Bucket names must be globally unique and comply with naming requirements." }, { "name": "delimiter", "value": "/", "type": "query", "description": "Returns results in a directory-like mode. Items will contain only objects whose names, aside from the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter will have their name truncated after the delimiter, returned in prefixes. Duplicate prefixes are omitted." }, { "name": "endOffset", "value": "", "type": "query", "description": "Filter results to objects whose names are lexicographically before endOffset. If startOffset is also set, the objects listed have names between startOffset (inclusive) and endOffset (exclusive)." }, { "name": "includeFoldersAsPrefixes", "value": "", "type": "query", "description": "Only applicable if delimiter is set to /. If true, will also include folders and managed folders (besides objects) in the returned prefixes." }, { "name": "includeTrailingDelimiter", "value": "", "type": "query", "description": "If true, objects that end in exactly one instance of delimiter will have their metadata included in items in addition to prefixes." }, { "name": "matchGlob", "value": "", "type": "query", "description": "Filter results to objects and prefixes that match this glob pattern. Supports *, **, ?, and [...] character classes." }, { "name": "maxResults", "value": "", "type": "query", "description": "Maximum number of items plus prefixes to return in a single page of responses. The service may return fewer than this value." }, { "name": "pageToken", "value": "", "type": "query", "description": "A previously-returned page token representing part of the larger set of results to view." }, { "name": "prefix", "value": "", "type": "query", "description": "Filter results to objects whose names begin with this prefix." }, { "name": "projection", "value": "", "type": "query", "description": "Set of properties to return. Defaults to noAcl." }, { "name": "softDeleted", "value": "", "type": "query", "description": "If true, only lists soft-deleted object versions." }, { "name": "startOffset", "value": "", "type": "query", "description": "Filter results to objects whose names are lexicographically equal to or after startOffset." }, { "name": "versions", "value": "", "type": "query", "description": "If true, lists all versions of an object as distinct results. The default is false." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying a subset of fields to include in the response. Use for better performance by retrieving only needed fields." }, { "name": "prettyPrint", "value": "", "type": "query", "description": "Returns response with indentations and line breaks. Default is true. When set to false, can reduce the response payload size." }, { "name": "userProject", "value": "", "type": "query", "description": "The project to be billed for this request. Required for Requester Pays buckets." } ] }, "docs": "Retrieves a list of objects matching the criteria. The authenticated user must have the storage.objects.list permission for the bucket. Lists objects in a bucket, optionally filtering by a prefix and delimiter to emulate directory listing." }, { "info": { "name": "Google Cloud Storage Get an Object", "type": "http" }, "http": { "method": "GET", "url": "https://storage.googleapis.com/storage/v1/b/:bucket/o/:object", "params": [ { "name": "bucket", "value": "my-bucket", "type": "path", "description": "Name of the bucket. Bucket names must be globally unique and comply with naming requirements." }, { "name": "object", "value": "my-object.txt", "type": "path", "description": "Name of the object. For information about how to URL-encode object names to be path safe, see Encoding URI path parts." }, { "name": "alt", "value": "", "type": "query", "description": "Data format for the response. Use json for metadata or media to download the object data." }, { "name": "generation", "value": "", "type": "query", "description": "If present, selects a specific revision of this object." }, { "name": "ifGenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object." }, { "name": "ifGenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current generation does not match the given value." }, { "name": "ifMetagenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current metageneration matches the given value." }, { "name": "ifMetagenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current metageneration does not match the given value." }, { "name": "projection", "value": "", "type": "query", "description": "Set of properties to return. Defaults to noAcl." }, { "name": "softDeleted", "value": "", "type": "query", "description": "If true, retrieves the soft-deleted version of the object." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying a subset of fields to include in the response. Use for better performance by retrieving only needed fields." }, { "name": "prettyPrint", "value": "", "type": "query", "description": "Returns response with indentations and line breaks. Default is true. When set to false, can reduce the response payload size." }, { "name": "userProject", "value": "", "type": "query", "description": "The project to be billed for this request. Required for Requester Pays buckets." } ] }, "docs": "Retrieves an object or its metadata. The authenticated user must have the storage.objects.get permission for the object. By default, this returns the object metadata. Use alt=media to download the object data." }, { "info": { "name": "Google Cloud Storage Update an Object", "type": "http" }, "http": { "method": "PUT", "url": "https://storage.googleapis.com/storage/v1/b/:bucket/o/:object", "params": [ { "name": "bucket", "value": "my-bucket", "type": "path", "description": "Name of the bucket. Bucket names must be globally unique and comply with naming requirements." }, { "name": "object", "value": "my-object.txt", "type": "path", "description": "Name of the object. For information about how to URL-encode object names to be path safe, see Encoding URI path parts." }, { "name": "generation", "value": "", "type": "query", "description": "If present, selects a specific revision of this object." }, { "name": "ifGenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current generation matches the given value." }, { "name": "ifGenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current generation does not match the given value." }, { "name": "ifMetagenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current metageneration matches the given value." }, { "name": "ifMetagenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current metageneration does not match the given value." }, { "name": "predefinedAcl", "value": "", "type": "query", "description": "Apply a predefined set of access controls to the object." }, { "name": "projection", "value": "", "type": "query", "description": "Set of properties to return. Defaults to full." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying a subset of fields to include in the response. Use for better performance by retrieving only needed fields." }, { "name": "prettyPrint", "value": "", "type": "query", "description": "Returns response with indentations and line breaks. Default is true. When set to false, can reduce the response payload size." }, { "name": "userProject", "value": "", "type": "query", "description": "The project to be billed for this request. Required for Requester Pays buckets." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Updates an object's metadata. This method replaces all mutable metadata fields of the object with the values in the request body." }, { "info": { "name": "Google Cloud Storage Patch an Object", "type": "http" }, "http": { "method": "PATCH", "url": "https://storage.googleapis.com/storage/v1/b/:bucket/o/:object", "params": [ { "name": "bucket", "value": "my-bucket", "type": "path", "description": "Name of the bucket. Bucket names must be globally unique and comply with naming requirements." }, { "name": "object", "value": "my-object.txt", "type": "path", "description": "Name of the object. For information about how to URL-encode object names to be path safe, see Encoding URI path parts." }, { "name": "generation", "value": "", "type": "query", "description": "If present, selects a specific revision of this object." }, { "name": "ifGenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current generation matches the given value." }, { "name": "ifGenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current generation does not match the given value." }, { "name": "ifMetagenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current metageneration matches the given value." }, { "name": "ifMetagenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current metageneration does not match the given value." }, { "name": "predefinedAcl", "value": "", "type": "query", "description": "Apply a predefined set of access controls to the object." }, { "name": "projection", "value": "", "type": "query", "description": "Set of properties to return. Defaults to full." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying a subset of fields to include in the response. Use for better performance by retrieving only needed fields." }, { "name": "prettyPrint", "value": "", "type": "query", "description": "Returns response with indentations and line breaks. Default is true. When set to false, can reduce the response payload size." }, { "name": "userProject", "value": "", "type": "query", "description": "The project to be billed for this request. Required for Requester Pays buckets." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Patches an object's metadata. This method supports patch semantics where only the specified fields are updated." }, { "info": { "name": "Google Cloud Storage Delete an Object", "type": "http" }, "http": { "method": "DELETE", "url": "https://storage.googleapis.com/storage/v1/b/:bucket/o/:object", "params": [ { "name": "bucket", "value": "my-bucket", "type": "path", "description": "Name of the bucket. Bucket names must be globally unique and comply with naming requirements." }, { "name": "object", "value": "my-object.txt", "type": "path", "description": "Name of the object. For information about how to URL-encode object names to be path safe, see Encoding URI path parts." }, { "name": "generation", "value": "", "type": "query", "description": "If present, permanently deletes a specific revision of this object." }, { "name": "ifGenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current generation matches the given value." }, { "name": "ifGenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current generation does not match the given value." }, { "name": "ifMetagenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current metageneration matches the given value." }, { "name": "ifMetagenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the object's current metageneration does not match the given value." }, { "name": "userProject", "value": "", "type": "query", "description": "The project to be billed for this request. Required for Requester Pays buckets." } ] }, "docs": "Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for the bucket, or if the object is not the latest version. When versioning is enabled, deleting the latest version creates a delete marker." }, { "info": { "name": "Google Cloud Storage Compose Objects", "type": "http" }, "http": { "method": "POST", "url": "https://storage.googleapis.com/storage/v1/b/:bucket/o/:object/compose", "params": [ { "name": "bucket", "value": "my-bucket", "type": "path", "description": "Name of the bucket. Bucket names must be globally unique and comply with naming requirements." }, { "name": "object", "value": "", "type": "path", "description": "Name of the destination object." }, { "name": "ifGenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the destination object's current generation matches the given value." }, { "name": "ifMetagenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the destination object's current metageneration matches the given value." }, { "name": "userProject", "value": "", "type": "query", "description": "The project to be billed for this request. Required for Requester Pays buckets." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Concatenates a list of existing objects into a new object in the same bucket. The composed object can contain no more than 32 source objects. The destination object's metadata is identical to that of the first source object unless overridden." }, { "info": { "name": "Google Cloud Storage Copy an Object", "type": "http" }, "http": { "method": "POST", "url": "https://storage.googleapis.com/storage/v1/b/:bucket/o/:object/copyTo/b/:destinationBucket/o/:destinationObject", "params": [ { "name": "bucket", "value": "", "type": "path", "description": "Name of the source bucket." }, { "name": "object", "value": "", "type": "path", "description": "Name of the source object. For information about how to URL-encode object names, see Encoding URI path parts." }, { "name": "destinationBucket", "value": "", "type": "path", "description": "Name of the destination bucket." }, { "name": "destinationObject", "value": "", "type": "path", "description": "Name of the destination object." }, { "name": "destinationPredefinedAcl", "value": "", "type": "query", "description": "Apply a predefined set of access controls to the destination object." }, { "name": "ifGenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the destination object's current generation matches the given value." }, { "name": "ifGenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the destination object's current generation does not match the given value." }, { "name": "ifMetagenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the destination object's current metageneration matches the given value." }, { "name": "ifMetagenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the destination object's current metageneration does not match the given value." }, { "name": "ifSourceGenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the source object's current generation matches the given value." }, { "name": "ifSourceGenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the source object's current generation does not match the given value." }, { "name": "ifSourceMetagenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the source object's current metageneration matches the given value." }, { "name": "ifSourceMetagenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the source object's current metageneration does not match the given value." }, { "name": "projection", "value": "", "type": "query", "description": "Set of properties to return. Defaults to noAcl." }, { "name": "sourceGeneration", "value": "", "type": "query", "description": "If present, selects a specific revision of the source object." }, { "name": "userProject", "value": "", "type": "query", "description": "The project to be billed for this request. Required for Requester Pays buckets." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Copies a source object to a destination object. Optionally overrides metadata. This method creates a copy of an object as a new object in the destination bucket." }, { "info": { "name": "Google Cloud Storage Rewrite an Object", "type": "http" }, "http": { "method": "POST", "url": "https://storage.googleapis.com/storage/v1/b/:bucket/o/:object/rewriteTo/b/:destinationBucket/o/:destinationObject", "params": [ { "name": "bucket", "value": "", "type": "path", "description": "Name of the source bucket." }, { "name": "object", "value": "", "type": "path", "description": "Name of the source object." }, { "name": "destinationBucket", "value": "", "type": "path", "description": "Name of the destination bucket." }, { "name": "destinationObject", "value": "", "type": "path", "description": "Name of the destination object." }, { "name": "destinationKmsKeyName", "value": "", "type": "query", "description": "Resource name of the Cloud KMS key that will be used to encrypt the destination object." }, { "name": "destinationPredefinedAcl", "value": "", "type": "query", "description": "Apply a predefined set of access controls to the destination object." }, { "name": "ifGenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the destination object's current generation matches the given value." }, { "name": "ifGenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the destination object's current generation does not match the given value." }, { "name": "ifMetagenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the destination object's current metageneration matches the given value." }, { "name": "ifMetagenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the destination object's current metageneration does not match the given value." }, { "name": "ifSourceGenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the source object's current generation matches the given value." }, { "name": "ifSourceGenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the source object's current generation does not match the given value." }, { "name": "ifSourceMetagenerationMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the source object's current metageneration matches the given value." }, { "name": "ifSourceMetagenerationNotMatch", "value": "", "type": "query", "description": "Makes the operation conditional on whether the source object's current metageneration does not match the given value." }, { "name": "maxBytesRewrittenPerCall", "value": "", "type": "query", "description": "The maximum number of bytes that will be rewritten per rewrite request. Allows throttling of large copies." }, { "name": "projection", "value": "", "type": "query", "description": "Set of properties to return. Defaults to noAcl." }, { "name": "rewriteToken", "value": "", "type": "query", "description": "Include this field only if the previous rewrite response included a rewriteToken. Provides a token for resuming a previously started rewrite operation." }, { "name": "sourceGeneration", "value": "", "type": "query", "description": "If present, selects a specific revision of the source object." }, { "name": "userProject", "value": "", "type": "query", "description": "The project to be billed for this request. Required for Requester Pays buckets." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Rewrites a source object to a destination object. Optionally overrides metadata. This method can copy objects across locations and storage classes, and can also be used to change an object's encryption key. For large objects, this method may require multiple calls." }, { "info": { "name": "Google Cloud Storage Watch for Object Changes", "type": "http" }, "http": { "method": "POST", "url": "https://storage.googleapis.com/storage/v1/b/:bucket/o/watchAll", "params": [ { "name": "bucket", "value": "my-bucket", "type": "path", "description": "Name of the bucket. Bucket names must be globally unique and comply with naming requirements." }, { "name": "prefix", "value": "", "type": "query", "description": "Limits notifications to objects with names beginning with this prefix." }, { "name": "userProject", "value": "", "type": "query", "description": "The project to be billed for this request. Required for Requester Pays buckets." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Watch for changes on all objects in a bucket. This method creates a notification channel that sends a notification whenever an object is created, updated, or deleted." }, { "info": { "name": "Google Cloud Storage Stop a Notification Channel", "type": "http" }, "http": { "method": "POST", "url": "https://storage.googleapis.com/storage/v1/channels/stop", "body": { "type": "json", "data": "{}" } }, "docs": "Stop receiving object change notifications through a previously created watch channel." } ] } ], "bundled": true }