{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://zieapi.vercel.app"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/analytics:googleapis-books/books-bookshelves-get":{"get":{"operationId":"analytics_googleapis_books_books_bookshelves_get","summary":"Retrieves metadata for a specific bookshelf for the specified user.","description":"GET /books/v1/users/{userId}/bookshelves/{shelf}","tags":["analytics"],"parameters":[{"name":"shelf","in":"query","required":true,"description":"ID of bookshelf to retrieve.","schema":{"type":"string","description":"ID of bookshelf to retrieve."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"userId","in":"query","required":true,"description":"ID of user for whom to retrieve bookshelves.","schema":{"type":"string","description":"ID of user for whom to retrieve bookshelves."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-bookshelves-list":{"get":{"operationId":"analytics_googleapis_books_books_bookshelves_list","summary":"Retrieves a list of public bookshelves for the specified user.","description":"GET /books/v1/users/{userId}/bookshelves","tags":["analytics"],"parameters":[{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"userId","in":"query","required":true,"description":"ID of user for whom to retrieve bookshelves.","schema":{"type":"string","description":"ID of user for whom to retrieve bookshelves."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-bookshelves-volumes-list":{"get":{"operationId":"analytics_googleapis_books_books_bookshelves_volumes_list","summary":"Retrieves volumes in a specific bookshelf for the specified user.","description":"GET /books/v1/users/{userId}/bookshelves/{shelf}/volumes","tags":["analytics"],"parameters":[{"name":"maxResults","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","description":"Maximum number of results to return"}},{"name":"shelf","in":"query","required":true,"description":"ID of bookshelf to retrieve volumes.","schema":{"type":"string","description":"ID of bookshelf to retrieve volumes."}},{"name":"showPreorders","in":"query","required":false,"description":"Set to true to show pre-ordered books. Defaults to false.","schema":{"type":"boolean","description":"Set to true to show pre-ordered books. Defaults to false."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"startIndex","in":"query","required":false,"description":"Index of the first element to return (starts at 0)","schema":{"type":"integer","description":"Index of the first element to return (starts at 0)"}},{"name":"userId","in":"query","required":true,"description":"ID of user for whom to retrieve bookshelf volumes.","schema":{"type":"string","description":"ID of user for whom to retrieve bookshelf volumes."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-cloudloading-add-book":{"post":{"operationId":"analytics_googleapis_books_books_cloudloading_add_book","summary":"Add a user-upload volume and triggers processing.","description":"POST /books/v1/cloudloading/addBook","tags":["analytics"],"parameters":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"drive_document_id":{"type":"string","description":"A drive document id. The upload_client_token must not be set."},"mime_type":{"type":"string","description":"The document MIME type. It can be set only if the drive_document_id is set."},"name":{"type":"string","description":"The document name. It can be set only if the drive_document_id is set."},"upload_client_token":{"type":"string","description":"Scotty upload token."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-cloudloading-delete-book":{"post":{"operationId":"analytics_googleapis_books_books_cloudloading_delete_book","summary":"Remove the book and its contents","description":"POST /books/v1/cloudloading/deleteBook","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["volumeId"],"properties":{"volumeId":{"type":"string","description":"The id of the book to be removed."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-cloudloading-update-book":{"post":{"operationId":"analytics_googleapis_books_books_cloudloading_update_book","summary":"Updates a user-upload volume.","description":"POST /books/v1/cloudloading/updateBook","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"object","description":"JSON request body"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-dictionary-list-offline-metadata":{"get":{"operationId":"analytics_googleapis_books_books_dictionary_list_offline_metadata","summary":"Returns a list of offline dictionary metadata available","description":"GET /books/v1/dictionary/listOfflineMetadata","tags":["analytics"],"parameters":[{"name":"cpksver","in":"query","required":true,"description":"The device/version ID from which to request the data.","schema":{"type":"string","description":"The device/version ID from which to request the data."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-familysharing-get-family-info":{"get":{"operationId":"analytics_googleapis_books_books_familysharing_get_family_info","summary":"Gets information regarding the family that the user is part of.","description":"GET /books/v1/familysharing/getFamilyInfo","tags":["analytics"],"parameters":[{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-familysharing-share":{"post":{"operationId":"analytics_googleapis_books_books_familysharing_share","summary":"Initiates sharing of the content with the user's family. Empty response indicates success.","description":"POST /books/v1/familysharing/share","tags":["analytics"],"parameters":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"docId":{"type":"string","description":"The docid to share."},"source":{"type":"string","description":"String to identify the originator of this request."},"volumeId":{"type":"string","description":"The volume to share."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-familysharing-unshare":{"post":{"operationId":"analytics_googleapis_books_books_familysharing_unshare","summary":"Initiates revoking content that has already been shared with the user's family. Empty response indicates…","description":"POST /books/v1/familysharing/unshare","tags":["analytics"],"parameters":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"docId":{"type":"string","description":"The docid to unshare."},"source":{"type":"string","description":"String to identify the originator of this request."},"volumeId":{"type":"string","description":"The volume to unshare."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-layers-get":{"get":{"operationId":"analytics_googleapis_books_books_layers_get","summary":"Gets the layer summary for a volume.","description":"GET /books/v1/volumes/{volumeId}/layersummary/{summaryId}","tags":["analytics"],"parameters":[{"name":"contentVersion","in":"query","required":false,"description":"The content version for the requested volume.","schema":{"type":"string","description":"The content version for the requested volume."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"summaryId","in":"query","required":true,"description":"The ID for the layer to get the summary for.","schema":{"type":"string","description":"The ID for the layer to get the summary for."}},{"name":"volumeId","in":"query","required":true,"description":"The volume to retrieve layers for.","schema":{"type":"string","description":"The volume to retrieve layers for."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-layers-list":{"get":{"operationId":"analytics_googleapis_books_books_layers_list","summary":"List the layer summaries for a volume.","description":"GET /books/v1/volumes/{volumeId}/layersummary","tags":["analytics"],"parameters":[{"name":"contentVersion","in":"query","required":false,"description":"The content version for the requested volume.","schema":{"type":"string","description":"The content version for the requested volume."}},{"name":"maxResults","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","description":"Maximum number of results to return"}},{"name":"pageToken","in":"query","required":false,"description":"The value of the nextToken from the previous page.","schema":{"type":"string","description":"The value of the nextToken from the previous page."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"volumeId","in":"query","required":true,"description":"The volume to retrieve layers for.","schema":{"type":"string","description":"The volume to retrieve layers for."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-layers-annotation-data-get":{"get":{"operationId":"analytics_googleapis_books_books_layers_annotation_data_get","summary":"Gets the annotation data.","description":"GET /books/v1/volumes/{volumeId}/layers/{layerId}/data/{annotationDataId}","tags":["analytics"],"parameters":[{"name":"allowWebDefinitions","in":"query","required":false,"description":"For the dictionary layer. Whether or not to allow web definitions.","schema":{"type":"boolean","description":"For the dictionary layer. Whether or not to allow web definitions."}},{"name":"annotationDataId","in":"query","required":true,"description":"The ID of the annotation data to retrieve.","schema":{"type":"string","description":"The ID of the annotation data to retrieve."}},{"name":"contentVersion","in":"query","required":true,"description":"The content version for the volume you are trying to retrieve.","schema":{"type":"string","description":"The content version for the volume you are trying to retrieve."}},{"name":"h","in":"query","required":false,"description":"The requested pixel height for any images. If height is provided width must also be provided.","schema":{"type":"integer","description":"The requested pixel height for any images. If height is provided width must also be provided."}},{"name":"layerId","in":"query","required":true,"description":"The ID for the layer to get the annotations.","schema":{"type":"string","description":"The ID for the layer to get the annotations."}},{"name":"locale","in":"query","required":false,"description":"The locale information for the data. ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'.","schema":{"type":"string","description":"The locale information for the data. ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'."}},{"name":"scale","in":"query","required":false,"description":"The requested scale for the image.","schema":{"type":"integer","description":"The requested scale for the image."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"volumeId","in":"query","required":true,"description":"The volume to retrieve annotations for.","schema":{"type":"string","description":"The volume to retrieve annotations for."}},{"name":"w","in":"query","required":false,"description":"The requested pixel width for any images. If width is provided height must also be provided.","schema":{"type":"integer","description":"The requested pixel width for any images. If width is provided height must also be provided."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-layers-annotation-data-list":{"get":{"operationId":"analytics_googleapis_books_books_layers_annotation_data_list","summary":"Gets the annotation data for a volume and layer.","description":"GET /books/v1/volumes/{volumeId}/layers/{layerId}/data","tags":["analytics"],"parameters":[{"name":"annotationDataId","in":"query","required":false,"description":"The list of Annotation Data Ids to retrieve. Pagination is ignored if this is set.","schema":{"type":"string","description":"The list of Annotation Data Ids to retrieve. Pagination is ignored if this is set."}},{"name":"contentVersion","in":"query","required":true,"description":"The content version for the requested volume.","schema":{"type":"string","description":"The content version for the requested volume."}},{"name":"h","in":"query","required":false,"description":"The requested pixel height for any images. If height is provided width must also be provided.","schema":{"type":"integer","description":"The requested pixel height for any images. If height is provided width must also be provided."}},{"name":"layerId","in":"query","required":true,"description":"The ID for the layer to get the annotation data.","schema":{"type":"string","description":"The ID for the layer to get the annotation data."}},{"name":"locale","in":"query","required":false,"description":"The locale information for the data. ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'.","schema":{"type":"string","description":"The locale information for the data. ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'."}},{"name":"maxResults","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","description":"Maximum number of results to return"}},{"name":"pageToken","in":"query","required":false,"description":"The value of the nextToken from the previous page.","schema":{"type":"string","description":"The value of the nextToken from the previous page."}},{"name":"scale","in":"query","required":false,"description":"The requested scale for the image.","schema":{"type":"integer","description":"The requested scale for the image."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"updatedMax","in":"query","required":false,"description":"RFC 3339 timestamp to restrict to items updated prior to this timestamp (exclusive).","schema":{"type":"string","description":"RFC 3339 timestamp to restrict to items updated prior to this timestamp (exclusive)."}},{"name":"updatedMin","in":"query","required":false,"description":"RFC 3339 timestamp to restrict to items updated since this timestamp (inclusive).","schema":{"type":"string","description":"RFC 3339 timestamp to restrict to items updated since this timestamp (inclusive)."}},{"name":"volumeId","in":"query","required":true,"description":"The volume to retrieve annotation data for.","schema":{"type":"string","description":"The volume to retrieve annotation data for."}},{"name":"w","in":"query","required":false,"description":"The requested pixel width for any images. If width is provided height must also be provided.","schema":{"type":"integer","description":"The requested pixel width for any images. If width is provided height must also be provided."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-layers-volume-annotations-get":{"get":{"operationId":"analytics_googleapis_books_books_layers_volume_annotations_get","summary":"Gets the volume annotation.","description":"GET /books/v1/volumes/{volumeId}/layers/{layerId}/annotations/{annotationId}","tags":["analytics"],"parameters":[{"name":"annotationId","in":"query","required":true,"description":"The ID of the volume annotation to retrieve.","schema":{"type":"string","description":"The ID of the volume annotation to retrieve."}},{"name":"layerId","in":"query","required":true,"description":"The ID for the layer to get the annotations.","schema":{"type":"string","description":"The ID for the layer to get the annotations."}},{"name":"locale","in":"query","required":false,"description":"The locale information for the data. ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'.","schema":{"type":"string","description":"The locale information for the data. ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"volumeId","in":"query","required":true,"description":"The volume to retrieve annotations for.","schema":{"type":"string","description":"The volume to retrieve annotations for."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-layers-volume-annotations-list":{"get":{"operationId":"analytics_googleapis_books_books_layers_volume_annotations_list","summary":"Gets the volume annotations for a volume and layer.","description":"GET /books/v1/volumes/{volumeId}/layers/{layerId}","tags":["analytics"],"parameters":[{"name":"contentVersion","in":"query","required":true,"description":"The content version for the requested volume.","schema":{"type":"string","description":"The content version for the requested volume."}},{"name":"endOffset","in":"query","required":false,"description":"The end offset to end retrieving data from.","schema":{"type":"string","description":"The end offset to end retrieving data from."}},{"name":"endPosition","in":"query","required":false,"description":"The end position to end retrieving data from.","schema":{"type":"string","description":"The end position to end retrieving data from."}},{"name":"layerId","in":"query","required":true,"description":"The ID for the layer to get the annotations.","schema":{"type":"string","description":"The ID for the layer to get the annotations."}},{"name":"locale","in":"query","required":false,"description":"The locale information for the data. ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'.","schema":{"type":"string","description":"The locale information for the data. ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'."}},{"name":"maxResults","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","description":"Maximum number of results to return"}},{"name":"pageToken","in":"query","required":false,"description":"The value of the nextToken from the previous page.","schema":{"type":"string","description":"The value of the nextToken from the previous page."}},{"name":"showDeleted","in":"query","required":false,"description":"Set to true to return deleted annotations. updatedMin must be in the request to use this. Defaults to false.","schema":{"type":"boolean","description":"Set to true to return deleted annotations. updatedMin must be in the request to use this. Defaults to false."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"startOffset","in":"query","required":false,"description":"The start offset to start retrieving data from.","schema":{"type":"string","description":"The start offset to start retrieving data from."}},{"name":"startPosition","in":"query","required":false,"description":"The start position to start retrieving data from.","schema":{"type":"string","description":"The start position to start retrieving data from."}},{"name":"updatedMax","in":"query","required":false,"description":"RFC 3339 timestamp to restrict to items updated prior to this timestamp (exclusive).","schema":{"type":"string","description":"RFC 3339 timestamp to restrict to items updated prior to this timestamp (exclusive)."}},{"name":"updatedMin","in":"query","required":false,"description":"RFC 3339 timestamp to restrict to items updated since this timestamp (inclusive).","schema":{"type":"string","description":"RFC 3339 timestamp to restrict to items updated since this timestamp (inclusive)."}},{"name":"volumeAnnotationsVersion","in":"query","required":false,"description":"The version of the volume annotations that you are requesting.","schema":{"type":"string","description":"The version of the volume annotations that you are requesting."}},{"name":"volumeId","in":"query","required":true,"description":"The volume to retrieve annotations for.","schema":{"type":"string","description":"The volume to retrieve annotations for."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-myconfig-get-user-settings":{"get":{"operationId":"analytics_googleapis_books_books_myconfig_get_user_settings","summary":"Gets the current settings for the user.","description":"GET /books/v1/myconfig/getUserSettings","tags":["analytics"],"parameters":[{"name":"country","in":"query","required":false,"description":"Unused. Added only to workaround TEX mandatory request template requirement","schema":{"type":"string","description":"Unused. Added only to workaround TEX mandatory request template requirement"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-myconfig-release-download-access":{"post":{"operationId":"analytics_googleapis_books_books_myconfig_release_download_access","summary":"Release downloaded content access restriction.","description":"POST /books/v1/myconfig/releaseDownloadAccess","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["cpksver","volumeIds"],"properties":{"cpksver":{"type":"string","description":"The device/version ID from which to release the restriction."},"locale":{"type":"string","description":"ISO-639-1, ISO-3166-1 codes for message localization, i.e. en_US."},"source":{"type":"string","description":"String to identify the originator of this request."},"volumeIds":{"type":"string","description":"The volume(s) to release restrictions for."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-myconfig-request-access":{"post":{"operationId":"analytics_googleapis_books_books_myconfig_request_access","summary":"Request concurrent and download access restrictions.","description":"POST /books/v1/myconfig/requestAccess","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["cpksver","nonce","source","volumeId"],"properties":{"cpksver":{"type":"string","description":"The device/version ID from which to request the restrictions."},"licenseTypes":{"type":"string","enum":["LICENSE_TYPES_UNDEFINED","BOTH","CONCURRENT","DOWNLOAD"],"description":"The type of access license to request. If not specified, the default is BOTH."},"locale":{"type":"string","description":"ISO-639-1, ISO-3166-1 codes for message localization, i.e. en_US."},"nonce":{"type":"string","description":"The client nonce value."},"source":{"type":"string","description":"String to identify the originator of this request."},"volumeId":{"type":"string","description":"The volume to request concurrent/download restrictions for."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-myconfig-sync-volume-licenses":{"post":{"operationId":"analytics_googleapis_books_books_myconfig_sync_volume_licenses","summary":"Request downloaded content access for specified volumes on the My eBooks shelf.","description":"POST /books/v1/myconfig/syncVolumeLicenses","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["cpksver","nonce","source"],"properties":{"cpksver":{"type":"string","description":"The device/version ID from which to release the restriction."},"features":{"type":"string","enum":["FEATURES_UNDEFINED","RENTALS"],"description":"List of features supported by the client, i.e., 'RENTALS'"},"includeNonComicsSeries":{"type":"boolean","description":"Set to true to include non-comics series. Defaults to false."},"locale":{"type":"string","description":"ISO-639-1, ISO-3166-1 codes for message localization, i.e. en_US."},"nonce":{"type":"string","description":"The client nonce value."},"showPreorders":{"type":"boolean","description":"Set to true to show pre-ordered books. Defaults to false."},"source":{"type":"string","description":"String to identify the originator of this request."},"volumeIds":{"type":"string","description":"The volume(s) to request download restrictions for."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-myconfig-update-user-settings":{"post":{"operationId":"analytics_googleapis_books_books_myconfig_update_user_settings","summary":"Sets the settings for the user. If a sub-object is specified, it will overwrite the existing sub-object…","description":"POST /books/v1/myconfig/updateUserSettings","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"object","description":"JSON request body"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-annotations-update":{"post":{"operationId":"analytics_googleapis_books_books_mylibrary_annotations_update","summary":"Updates an existing annotation.","description":"PUT /books/v1/mylibrary/annotations/{annotationId}","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["annotationId","body"],"properties":{"annotationId":{"type":"string","description":"The ID for the annotation to update."},"source":{"type":"string","description":"String to identify the originator of this request."},"body":{"type":"object","description":"JSON request body"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-annotations-delete":{"post":{"operationId":"analytics_googleapis_books_books_mylibrary_annotations_delete","summary":"Deletes an annotation.","description":"DELETE /books/v1/mylibrary/annotations/{annotationId}","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["annotationId"],"properties":{"annotationId":{"type":"string","description":"The ID for the annotation to delete."},"source":{"type":"string","description":"String to identify the originator of this request."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-annotations-list":{"get":{"operationId":"analytics_googleapis_books_books_mylibrary_annotations_list","summary":"Retrieves a list of annotations, possibly filtered.","description":"GET /books/v1/mylibrary/annotations","tags":["analytics"],"parameters":[{"name":"contentVersion","in":"query","required":false,"description":"The content version for the requested volume.","schema":{"type":"string","description":"The content version for the requested volume."}},{"name":"layerId","in":"query","required":false,"description":"The layer ID to limit annotation by.","schema":{"type":"string","description":"The layer ID to limit annotation by."}},{"name":"layerIds","in":"query","required":false,"description":"The layer ID(s) to limit annotation by.","schema":{"type":"string","description":"The layer ID(s) to limit annotation by."}},{"name":"maxResults","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","description":"Maximum number of results to return"}},{"name":"pageToken","in":"query","required":false,"description":"The value of the nextToken from the previous page.","schema":{"type":"string","description":"The value of the nextToken from the previous page."}},{"name":"showDeleted","in":"query","required":false,"description":"Set to true to return deleted annotations. updatedMin must be in the request to use this. Defaults to false.","schema":{"type":"boolean","description":"Set to true to return deleted annotations. updatedMin must be in the request to use this. Defaults to false."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"updatedMax","in":"query","required":false,"description":"RFC 3339 timestamp to restrict to items updated prior to this timestamp (exclusive).","schema":{"type":"string","description":"RFC 3339 timestamp to restrict to items updated prior to this timestamp (exclusive)."}},{"name":"updatedMin","in":"query","required":false,"description":"RFC 3339 timestamp to restrict to items updated since this timestamp (inclusive).","schema":{"type":"string","description":"RFC 3339 timestamp to restrict to items updated since this timestamp (inclusive)."}},{"name":"volumeId","in":"query","required":false,"description":"The volume to restrict annotations to.","schema":{"type":"string","description":"The volume to restrict annotations to."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-annotations-insert":{"post":{"operationId":"analytics_googleapis_books_books_mylibrary_annotations_insert","summary":"Inserts a new annotation.","description":"POST /books/v1/mylibrary/annotations","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"annotationId":{"type":"string","description":"The ID for the annotation to insert."},"country":{"type":"string","description":"ISO-3166-1 code to override the IP-based location."},"showOnlySummaryInResponse":{"type":"boolean","description":"Requests that only the summary of the specified layer be provided in the response."},"source":{"type":"string","description":"String to identify the originator of this request."},"body":{"type":"object","description":"JSON request body"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-annotations-summary":{"post":{"operationId":"analytics_googleapis_books_books_mylibrary_annotations_summary","summary":"Gets the summary of specified layers.","description":"POST /books/v1/mylibrary/annotations/summary","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["layerIds","volumeId"],"properties":{"layerIds":{"type":"string","description":"Array of layer IDs to get the summary for."},"source":{"type":"string","description":"Optional. String to identify the originator of this request."},"volumeId":{"type":"string","description":"Volume id to get the summary for."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-bookshelves-add-volume":{"post":{"operationId":"analytics_googleapis_books_books_mylibrary_bookshelves_add_volume","summary":"Adds a volume to a bookshelf.","description":"POST /books/v1/mylibrary/bookshelves/{shelf}/addVolume","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["shelf","volumeId"],"properties":{"reason":{"type":"string","enum":["REASON_UNDEFINED","IOS_PREX","IOS_SEARCH","ONBOARDING"],"description":"The reason for which the book is added to the library."},"shelf":{"type":"string","description":"ID of bookshelf to which to add a volume."},"source":{"type":"string","description":"String to identify the originator of this request."},"volumeId":{"type":"string","description":"ID of volume to add."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-bookshelves-clear-volumes":{"post":{"operationId":"analytics_googleapis_books_books_mylibrary_bookshelves_clear_volumes","summary":"Clears all volumes from a bookshelf.","description":"POST /books/v1/mylibrary/bookshelves/{shelf}/clearVolumes","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["shelf"],"properties":{"shelf":{"type":"string","description":"ID of bookshelf from which to remove a volume."},"source":{"type":"string","description":"String to identify the originator of this request."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-bookshelves-get":{"get":{"operationId":"analytics_googleapis_books_books_mylibrary_bookshelves_get","summary":"Retrieves metadata for a specific bookshelf belonging to the authenticated user.","description":"GET /books/v1/mylibrary/bookshelves/{shelf}","tags":["analytics"],"parameters":[{"name":"shelf","in":"query","required":true,"description":"ID of bookshelf to retrieve.","schema":{"type":"string","description":"ID of bookshelf to retrieve."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-bookshelves-list":{"get":{"operationId":"analytics_googleapis_books_books_mylibrary_bookshelves_list","summary":"Retrieves a list of bookshelves belonging to the authenticated user.","description":"GET /books/v1/mylibrary/bookshelves","tags":["analytics"],"parameters":[{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-bookshelves-move-volume":{"post":{"operationId":"analytics_googleapis_books_books_mylibrary_bookshelves_move_volume","summary":"Moves a volume within a bookshelf.","description":"POST /books/v1/mylibrary/bookshelves/{shelf}/moveVolume","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["shelf","volumeId","volumePosition"],"properties":{"shelf":{"type":"string","description":"ID of bookshelf with the volume."},"source":{"type":"string","description":"String to identify the originator of this request."},"volumeId":{"type":"string","description":"ID of volume to move."},"volumePosition":{"type":"integer","description":"Position on shelf to move the item (0 puts the item before the current first item, 1 puts it between the first and the second and so on.)"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-bookshelves-remove-volume":{"post":{"operationId":"analytics_googleapis_books_books_mylibrary_bookshelves_remove_volume","summary":"Removes a volume from a bookshelf.","description":"POST /books/v1/mylibrary/bookshelves/{shelf}/removeVolume","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["shelf","volumeId"],"properties":{"reason":{"type":"string","enum":["REASON_UNDEFINED","ONBOARDING"],"description":"The reason for which the book is removed from the library."},"shelf":{"type":"string","description":"ID of bookshelf from which to remove a volume."},"source":{"type":"string","description":"String to identify the originator of this request."},"volumeId":{"type":"string","description":"ID of volume to remove."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-bookshelves-volumes-list":{"get":{"operationId":"analytics_googleapis_books_books_mylibrary_bookshelves_volumes_list","summary":"Gets volume information for volumes on a bookshelf.","description":"GET /books/v1/mylibrary/bookshelves/{shelf}/volumes","tags":["analytics"],"parameters":[{"name":"country","in":"query","required":false,"description":"ISO-3166-1 code to override the IP-based location.","schema":{"type":"string","description":"ISO-3166-1 code to override the IP-based location."}},{"name":"maxResults","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","description":"Maximum number of results to return"}},{"name":"projection","in":"query","required":false,"description":"Restrict information returned to a set of selected fields.","schema":{"type":"string","enum":["PROJECTION_UNDEFINED","FULL","LITE"],"description":"Restrict information returned to a set of selected fields."}},{"name":"q","in":"query","required":false,"description":"Full-text search query string in this bookshelf.","schema":{"type":"string","description":"Full-text search query string in this bookshelf."}},{"name":"shelf","in":"query","required":true,"description":"The bookshelf ID or name retrieve volumes for.","schema":{"type":"string","description":"The bookshelf ID or name retrieve volumes for."}},{"name":"showPreorders","in":"query","required":false,"description":"Set to true to show pre-ordered books. Defaults to false.","schema":{"type":"boolean","description":"Set to true to show pre-ordered books. Defaults to false."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"startIndex","in":"query","required":false,"description":"Index of the first element to return (starts at 0)","schema":{"type":"integer","description":"Index of the first element to return (starts at 0)"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-readingpositions-get":{"get":{"operationId":"analytics_googleapis_books_books_mylibrary_readingpositions_get","summary":"Retrieves my reading position information for a volume.","description":"GET /books/v1/mylibrary/readingpositions/{volumeId}","tags":["analytics"],"parameters":[{"name":"contentVersion","in":"query","required":false,"description":"Volume content version for which this reading position is requested.","schema":{"type":"string","description":"Volume content version for which this reading position is requested."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"volumeId","in":"query","required":true,"description":"ID of volume for which to retrieve a reading position.","schema":{"type":"string","description":"ID of volume for which to retrieve a reading position."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-mylibrary-readingpositions-set-position":{"post":{"operationId":"analytics_googleapis_books_books_mylibrary_readingpositions_set_position","summary":"Sets my reading position information for a volume.","description":"POST /books/v1/mylibrary/readingpositions/{volumeId}/setPosition","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["position","timestamp","volumeId"],"properties":{"action":{"type":"string","enum":["ACTION_UNDEFINED","bookmark","chapter","next-page","prev-page","scroll","search"],"description":"Action that caused this reading position to be set."},"contentVersion":{"type":"string","description":"Volume content version for which this reading position applies."},"deviceCookie":{"type":"string","description":"Random persistent device cookie optional on set position."},"position":{"type":"string","description":"Position string for the new volume reading position."},"source":{"type":"string","description":"String to identify the originator of this request."},"timestamp":{"type":"string","description":"RFC 3339 UTC format timestamp associated with this reading position."},"volumeId":{"type":"string","description":"ID of volume for which to update the reading position."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-notification-get":{"get":{"operationId":"analytics_googleapis_books_books_notification_get","summary":"Returns notification details for a given notification id.","description":"GET /books/v1/notification/get","tags":["analytics"],"parameters":[{"name":"locale","in":"query","required":false,"description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating notification title and body.","schema":{"type":"string","description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating notification title and body."}},{"name":"notification_id","in":"query","required":true,"description":"String to identify the notification.","schema":{"type":"string","description":"String to identify the notification."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-onboarding-list-categories":{"get":{"operationId":"analytics_googleapis_books_books_onboarding_list_categories","summary":"List categories for onboarding experience.","description":"GET /books/v1/onboarding/listCategories","tags":["analytics"],"parameters":[{"name":"locale","in":"query","required":false,"description":"ISO-639-1 language and ISO-3166-1 country code. Default is en-US if unset.","schema":{"type":"string","description":"ISO-639-1 language and ISO-3166-1 country code. Default is en-US if unset."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-onboarding-list-category-volumes":{"get":{"operationId":"analytics_googleapis_books_books_onboarding_list_category_volumes","summary":"List available volumes under categories for onboarding experience.","description":"GET /books/v1/onboarding/listCategoryVolumes","tags":["analytics"],"parameters":[{"name":"categoryId","in":"query","required":false,"description":"List of category ids requested.","schema":{"type":"string","description":"List of category ids requested."}},{"name":"locale","in":"query","required":false,"description":"ISO-639-1 language and ISO-3166-1 country code. Default is en-US if unset.","schema":{"type":"string","description":"ISO-639-1 language and ISO-3166-1 country code. Default is en-US if unset."}},{"name":"maxAllowedMaturityRating","in":"query","required":false,"description":"The maximum allowed maturity rating of returned volumes. Books with a higher maturity rating are filtered out.","schema":{"type":"string","enum":["MAX_ALLOWED_MATURITY_RATING_UNDEFINED","MATURE","not-mature"],"description":"The maximum allowed maturity rating of returned volumes. Books with a higher maturity rating are filtered out."}},{"name":"pageSize","in":"query","required":false,"description":"Number of maximum results per page to be included in the response.","schema":{"type":"integer","description":"Number of maximum results per page to be included in the response."}},{"name":"pageToken","in":"query","required":false,"description":"The value of the nextToken from the previous page.","schema":{"type":"string","description":"The value of the nextToken from the previous page."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-personalizedstream-get":{"get":{"operationId":"analytics_googleapis_books_books_personalizedstream_get","summary":"Returns a stream of personalized book clusters","description":"GET /books/v1/personalizedstream/get","tags":["analytics"],"parameters":[{"name":"locale","in":"query","required":false,"description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating recommendations.","schema":{"type":"string","description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating recommendations."}},{"name":"maxAllowedMaturityRating","in":"query","required":false,"description":"The maximum allowed maturity rating of returned recommendations. Books with a higher maturity rating are filtered out.","schema":{"type":"string","enum":["MAX_ALLOWED_MATURITY_RATING_UNDEFINED","MATURE","not-mature"],"description":"The maximum allowed maturity rating of returned recommendations. Books with a higher maturity rating are filtered out."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-promooffer-accept":{"post":{"operationId":"analytics_googleapis_books_books_promooffer_accept","summary":"Accepts the promo offer.","description":"POST /books/v1/promooffer/accept","tags":["analytics"],"parameters":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"androidId":{"type":"string","description":"device android_id"},"device":{"type":"string","description":"device device"},"manufacturer":{"type":"string","description":"device manufacturer"},"model":{"type":"string","description":"device model"},"offerId":{"type":"string"},"product":{"type":"string","description":"device product"},"serial":{"type":"string","description":"device serial"},"volumeId":{"type":"string","description":"Volume id to exercise the offer"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-promooffer-dismiss":{"post":{"operationId":"analytics_googleapis_books_books_promooffer_dismiss","summary":"Marks the promo offer as dismissed.","description":"POST /books/v1/promooffer/dismiss","tags":["analytics"],"parameters":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"androidId":{"type":"string","description":"device android_id"},"device":{"type":"string","description":"device device"},"manufacturer":{"type":"string","description":"device manufacturer"},"model":{"type":"string","description":"device model"},"offerId":{"type":"string","description":"Offer to dimiss"},"product":{"type":"string","description":"device product"},"serial":{"type":"string","description":"device serial"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-promooffer-get":{"get":{"operationId":"analytics_googleapis_books_books_promooffer_get","summary":"Returns a list of promo offers available to the user","description":"GET /books/v1/promooffer/get","tags":["analytics"],"parameters":[{"name":"androidId","in":"query","required":false,"description":"device android_id","schema":{"type":"string","description":"device android_id"}},{"name":"device","in":"query","required":false,"description":"device device","schema":{"type":"string","description":"device device"}},{"name":"manufacturer","in":"query","required":false,"description":"device manufacturer","schema":{"type":"string","description":"device manufacturer"}},{"name":"model","in":"query","required":false,"description":"device model","schema":{"type":"string","description":"device model"}},{"name":"product","in":"query","required":false,"description":"device product","schema":{"type":"string","description":"device product"}},{"name":"serial","in":"query","required":false,"description":"device serial","schema":{"type":"string","description":"device serial"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-series-get":{"get":{"operationId":"analytics_googleapis_books_books_series_get","summary":"Returns Series metadata for the given series ids.","description":"GET /books/v1/series/get","tags":["analytics"],"parameters":[{"name":"series_id","in":"query","required":true,"description":"String that identifies the series","schema":{"type":"string","description":"String that identifies the series"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-series-membership-get":{"get":{"operationId":"analytics_googleapis_books_books_series_membership_get","summary":"Returns Series membership data given the series id.","description":"GET /books/v1/series/membership/get","tags":["analytics"],"parameters":[{"name":"page_size","in":"query","required":false,"description":"Number of maximum results per page to be included in the response.","schema":{"type":"integer","description":"Number of maximum results per page to be included in the response."}},{"name":"page_token","in":"query","required":false,"description":"The value of the nextToken from the previous page.","schema":{"type":"string","description":"The value of the nextToken from the previous page."}},{"name":"series_id","in":"query","required":true,"description":"String that identifies the series","schema":{"type":"string","description":"String that identifies the series"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-volumes-get":{"get":{"operationId":"analytics_googleapis_books_books_volumes_get","summary":"Gets volume information for a single volume.","description":"GET /books/v1/volumes/{volumeId}","tags":["analytics"],"parameters":[{"name":"country","in":"query","required":false,"description":"ISO-3166-1 code to override the IP-based location.","schema":{"type":"string","description":"ISO-3166-1 code to override the IP-based location."}},{"name":"includeNonComicsSeries","in":"query","required":false,"description":"Set to true to include non-comics series. Defaults to false.","schema":{"type":"boolean","description":"Set to true to include non-comics series. Defaults to false."}},{"name":"partner","in":"query","required":false,"description":"Brand results for partner ID.","schema":{"type":"string","description":"Brand results for partner ID."}},{"name":"projection","in":"query","required":false,"description":"Restrict information returned to a set of selected fields.","schema":{"type":"string","enum":["PROJECTION_UNDEFINED","FULL","LITE"],"description":"Restrict information returned to a set of selected fields."}},{"name":"source","in":"query","required":false,"description":"string to identify the originator of this request.","schema":{"type":"string","description":"string to identify the originator of this request."}},{"name":"user_library_consistent_read","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"volumeId","in":"query","required":true,"description":"ID of volume to retrieve.","schema":{"type":"string","description":"ID of volume to retrieve."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-volumes-list":{"get":{"operationId":"analytics_googleapis_books_books_volumes_list","summary":"Performs a book search.","description":"GET /books/v1/volumes","tags":["analytics"],"parameters":[{"name":"download","in":"query","required":false,"description":"Restrict to volumes by download availability.","schema":{"type":"string","enum":["DOWNLOAD_UNDEFINED","EPUB"],"description":"Restrict to volumes by download availability."}},{"name":"filter","in":"query","required":false,"description":"Filter search results.","schema":{"type":"string","enum":["FILTER_UNDEFINED","ebooks","free-ebooks","full","paid-ebooks","partial"],"description":"Filter search results."}},{"name":"langRestrict","in":"query","required":false,"description":"Restrict results to books with this language code.","schema":{"type":"string","description":"Restrict results to books with this language code."}},{"name":"libraryRestrict","in":"query","required":false,"description":"Restrict search to this user's library.","schema":{"type":"string","enum":["LIBRARY_RESTRICT_UNDEFINED","my-library","no-restrict"],"description":"Restrict search to this user's library."}},{"name":"maxAllowedMaturityRating","in":"query","required":false,"description":"The maximum allowed maturity rating of returned recommendations. Books with a higher maturity rating are filtered out.","schema":{"type":"string","enum":["MAX_ALLOWED_MATURITY_RATING_UNDEFINED","MATURE","not-mature"],"description":"The maximum allowed maturity rating of returned recommendations. Books with a higher maturity rating are filtered out."}},{"name":"maxResults","in":"query","required":false,"description":"Maximum number of results to return.","schema":{"type":"integer","description":"Maximum number of results to return."}},{"name":"orderBy","in":"query","required":false,"description":"Sort search results.","schema":{"type":"string","enum":["ORDER_BY_UNDEFINED","newest","relevance"],"description":"Sort search results."}},{"name":"partner","in":"query","required":false,"description":"Restrict and brand results for partner ID.","schema":{"type":"string","description":"Restrict and brand results for partner ID."}},{"name":"printType","in":"query","required":false,"description":"Restrict to books or magazines.","schema":{"type":"string","enum":["PRINT_TYPE_UNDEFINED","ALL","BOOKS","MAGAZINES"],"description":"Restrict to books or magazines."}},{"name":"projection","in":"query","required":false,"description":"Restrict information returned to a set of selected fields.","schema":{"type":"string","enum":["PROJECTION_UNDEFINED","FULL","LITE"],"description":"Restrict information returned to a set of selected fields."}},{"name":"q","in":"query","required":true,"description":"Full-text search query string.","schema":{"type":"string","description":"Full-text search query string."}},{"name":"showPreorders","in":"query","required":false,"description":"Set to true to show books available for preorder. Defaults to false.","schema":{"type":"boolean","description":"Set to true to show books available for preorder. Defaults to false."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"startIndex","in":"query","required":false,"description":"Index of the first result to return (starts at 0)","schema":{"type":"integer","description":"Index of the first result to return (starts at 0)"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-volumes-associated-list":{"get":{"operationId":"analytics_googleapis_books_books_volumes_associated_list","summary":"Return a list of associated books.","description":"GET /books/v1/volumes/{volumeId}/associated","tags":["analytics"],"parameters":[{"name":"association","in":"query","required":false,"description":"Association type.","schema":{"type":"string","enum":["ASSOCIATION_UNDEFINED","end-of-sample","end-of-volume","related-for-play"],"description":"Association type."}},{"name":"locale","in":"query","required":false,"description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating recommendations.","schema":{"type":"string","description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating recommendations."}},{"name":"maxAllowedMaturityRating","in":"query","required":false,"description":"The maximum allowed maturity rating of returned recommendations. Books with a higher maturity rating are filtered out.","schema":{"type":"string","enum":["MAX_ALLOWED_MATURITY_RATING_UNDEFINED","MATURE","not-mature"],"description":"The maximum allowed maturity rating of returned recommendations. Books with a higher maturity rating are filtered out."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"volumeId","in":"query","required":true,"description":"ID of the source volume.","schema":{"type":"string","description":"ID of the source volume."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-volumes-mybooks-list":{"get":{"operationId":"analytics_googleapis_books_books_volumes_mybooks_list","summary":"Return a list of books in My Library.","description":"GET /books/v1/volumes/mybooks","tags":["analytics"],"parameters":[{"name":"acquireMethod","in":"query","required":false,"description":"How the book was acquired","schema":{"type":"string","enum":["ACQUIRE_METHOD_UNDEFINED","FAMILY_SHARED","PREORDERED","PREVIOUSLY_RENTED","PUBLIC_DOMAIN","PURCHASED","RENTED","SAMPLE","UPLOADED"],"description":"How the book was acquired"}},{"name":"country","in":"query","required":false,"description":"ISO-3166-1 code to override the IP-based location.","schema":{"type":"string","description":"ISO-3166-1 code to override the IP-based location."}},{"name":"locale","in":"query","required":false,"description":"ISO-639-1 language and ISO-3166-1 country code. Ex:'en_US'. Used for generating recommendations.","schema":{"type":"string","description":"ISO-639-1 language and ISO-3166-1 country code. Ex:'en_US'. Used for generating recommendations."}},{"name":"maxResults","in":"query","required":false,"description":"Maximum number of results to return.","schema":{"type":"integer","description":"Maximum number of results to return."}},{"name":"processingState","in":"query","required":false,"description":"The processing state of the user uploaded volumes to be returned. Applicable only if the UPLOADED is specified in the acquireMethod.","schema":{"type":"string","enum":["PROCESSING_STATE_UNDEFINED","COMPLETED_FAILED","COMPLETED_SUCCESS","RUNNING"],"description":"The processing state of the user uploaded volumes to be returned. Applicable only if the UPLOADED is specified in the acquireMethod."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"startIndex","in":"query","required":false,"description":"Index of the first result to return (starts at 0)","schema":{"type":"integer","description":"Index of the first result to return (starts at 0)"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-volumes-recommended-list":{"get":{"operationId":"analytics_googleapis_books_books_volumes_recommended_list","summary":"Return a list of recommended books for the current user.","description":"GET /books/v1/volumes/recommended","tags":["analytics"],"parameters":[{"name":"locale","in":"query","required":false,"description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating recommendations.","schema":{"type":"string","description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating recommendations."}},{"name":"maxAllowedMaturityRating","in":"query","required":false,"description":"The maximum allowed maturity rating of returned recommendations. Books with a higher maturity rating are filtered out.","schema":{"type":"string","enum":["MAX_ALLOWED_MATURITY_RATING_UNDEFINED","MATURE","not-mature"],"description":"The maximum allowed maturity rating of returned recommendations. Books with a higher maturity rating are filtered out."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-volumes-recommended-rate":{"post":{"operationId":"analytics_googleapis_books_books_volumes_recommended_rate","summary":"Rate a recommended book for the current user.","description":"POST /books/v1/volumes/recommended/rate","tags":["analytics"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["rating","volumeId"],"properties":{"locale":{"type":"string","description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating recommendations."},"rating":{"type":"string","enum":["RATING_UNDEFINED","HAVE_IT","NOT_INTERESTED"],"description":"Rating to be given to the volume."},"source":{"type":"string","description":"String to identify the originator of this request."},"volumeId":{"type":"string","description":"ID of the source volume."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/analytics:googleapis-books/books-volumes-useruploaded-list":{"get":{"operationId":"analytics_googleapis_books_books_volumes_useruploaded_list","summary":"Return a list of books uploaded by the current user.","description":"GET /books/v1/volumes/useruploaded","tags":["analytics"],"parameters":[{"name":"locale","in":"query","required":false,"description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating recommendations.","schema":{"type":"string","description":"ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for generating recommendations."}},{"name":"maxResults","in":"query","required":false,"description":"Maximum number of results to return.","schema":{"type":"integer","description":"Maximum number of results to return."}},{"name":"processingState","in":"query","required":false,"description":"The processing state of the user uploaded volumes to be returned.","schema":{"type":"string","enum":["PROCESSING_STATE_UNDEFINED","COMPLETED_FAILED","COMPLETED_SUCCESS","RUNNING"],"description":"The processing state of the user uploaded volumes to be returned."}},{"name":"source","in":"query","required":false,"description":"String to identify the originator of this request.","schema":{"type":"string","description":"String to identify the originator of this request."}},{"name":"startIndex","in":"query","required":false,"description":"Index of the first result to return (starts at 0)","schema":{"type":"integer","description":"Index of the first result to return (starts at 0)"}},{"name":"volumeId","in":"query","required":false,"description":"The ids of the volumes to be returned. If not specified all that match the processingState are returned.","schema":{"type":"string","description":"The ids of the volumes to be returned. If not specified all that match the processingState are returned."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}