Method: archiveJobs.cancel
Stay organized with collections
Save and categorize content based on your preferences.
Cancels a Portability Archive job.
HTTP request
POST https://dataportability.googleapis.com/v1/{name=archiveJobs/*}:cancel
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
name |
string
Required. The Archive job ID you're canceling. This is returned by the InitiatePortabilityArchive response. The format is: archiveJobs/{archive_job}. Canceling is only executed if the job is in progress.
|
Request body
The request body must be empty.
Response body
If successful, the response body is empty.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/dataportability.alerts.subscriptions
https://www.googleapis.com/auth/dataportability.businessmessaging.conversations
https://www.googleapis.com/auth/dataportability.chrome.autofill
https://www.googleapis.com/auth/dataportability.chrome.bookmarks
https://www.googleapis.com/auth/dataportability.chrome.dictionary
https://www.googleapis.com/auth/dataportability.chrome.extensions
https://www.googleapis.com/auth/dataportability.chrome.history
https://www.googleapis.com/auth/dataportability.chrome.reading_list
https://www.googleapis.com/auth/dataportability.chrome.settings
https://www.googleapis.com/auth/dataportability.discover.follows
https://www.googleapis.com/auth/dataportability.discover.likes
https://www.googleapis.com/auth/dataportability.discover.not_interested
https://www.googleapis.com/auth/dataportability.maps.aliased_places
https://www.googleapis.com/auth/dataportability.maps.commute_routes
https://www.googleapis.com/auth/dataportability.maps.commute_settings
https://www.googleapis.com/auth/dataportability.maps.ev_profile
https://www.googleapis.com/auth/dataportability.maps.factual_contributions
https://www.googleapis.com/auth/dataportability.maps.offering_contributions
https://www.googleapis.com/auth/dataportability.maps.photos_videos
https://www.googleapis.com/auth/dataportability.maps.questions_answers
https://www.googleapis.com/auth/dataportability.maps.reviews
https://www.googleapis.com/auth/dataportability.maps.starred_places
https://www.googleapis.com/auth/dataportability.myactivity.maps
https://www.googleapis.com/auth/dataportability.myactivity.myadcenter
https://www.googleapis.com/auth/dataportability.myactivity.play
https://www.googleapis.com/auth/dataportability.myactivity.search
https://www.googleapis.com/auth/dataportability.myactivity.shopping
https://www.googleapis.com/auth/dataportability.myactivity.youtube
https://www.googleapis.com/auth/dataportability.mymaps.maps
https://www.googleapis.com/auth/dataportability.order_reserve.purchases_reservations
https://www.googleapis.com/auth/dataportability.play.devices
https://www.googleapis.com/auth/dataportability.play.grouping
https://www.googleapis.com/auth/dataportability.play.installs
https://www.googleapis.com/auth/dataportability.play.library
https://www.googleapis.com/auth/dataportability.play.playpoints
https://www.googleapis.com/auth/dataportability.play.promotions
https://www.googleapis.com/auth/dataportability.play.purchases
https://www.googleapis.com/auth/dataportability.play.redemptions
https://www.googleapis.com/auth/dataportability.play.subscriptions
https://www.googleapis.com/auth/dataportability.play.usersettings
https://www.googleapis.com/auth/dataportability.saved.collections
https://www.googleapis.com/auth/dataportability.search_ugc.comments
https://www.googleapis.com/auth/dataportability.search_ugc.media.reviews_and_stars
https://www.googleapis.com/auth/dataportability.search_ugc.media.streaming_video_providers
https://www.googleapis.com/auth/dataportability.search_ugc.media.thumbs
https://www.googleapis.com/auth/dataportability.search_ugc.media.watched
https://www.googleapis.com/auth/dataportability.searchnotifications.settings
https://www.googleapis.com/auth/dataportability.searchnotifications.subscriptions
https://www.googleapis.com/auth/dataportability.shopping.addresses
https://www.googleapis.com/auth/dataportability.shopping.reviews
https://www.googleapis.com/auth/dataportability.streetview.imagery
https://www.googleapis.com/auth/dataportability.youtube.channel
https://www.googleapis.com/auth/dataportability.youtube.clips
https://www.googleapis.com/auth/dataportability.youtube.comments
https://www.googleapis.com/auth/dataportability.youtube.live_chat
https://www.googleapis.com/auth/dataportability.youtube.music
https://www.googleapis.com/auth/dataportability.youtube.playable
https://www.googleapis.com/auth/dataportability.youtube.posts
https://www.googleapis.com/auth/dataportability.youtube.private_playlists
https://www.googleapis.com/auth/dataportability.youtube.private_videos
https://www.googleapis.com/auth/dataportability.youtube.public_playlists
https://www.googleapis.com/auth/dataportability.youtube.public_videos
https://www.googleapis.com/auth/dataportability.youtube.shopping
https://www.googleapis.com/auth/dataportability.youtube.subscriptions
https://www.googleapis.com/auth/dataportability.youtube.unlisted_playlists
https://www.googleapis.com/auth/dataportability.youtube.unlisted_videos
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-13 UTC.
[null,null,["Last updated 2025-02-13 UTC."],[],[],null,["# Method: archiveJobs.cancel\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCancels a Portability Archive job.\n\n### HTTP request\n\n`POST https://dataportability.googleapis.com/v1/{name=archiveJobs/*}:cancel`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The Archive job ID you're canceling. This is returned by the InitiatePortabilityArchive response. The format is: archiveJobs/{archive_job}. Canceling is only executed if the job is in progress. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/dataportability.alerts.subscriptions`\n- `https://www.googleapis.com/auth/dataportability.businessmessaging.conversations`\n- `https://www.googleapis.com/auth/dataportability.chrome.autofill`\n- `https://www.googleapis.com/auth/dataportability.chrome.bookmarks`\n- `https://www.googleapis.com/auth/dataportability.chrome.dictionary`\n- `https://www.googleapis.com/auth/dataportability.chrome.extensions`\n- `https://www.googleapis.com/auth/dataportability.chrome.history`\n- `https://www.googleapis.com/auth/dataportability.chrome.reading_list`\n- `https://www.googleapis.com/auth/dataportability.chrome.settings`\n- `https://www.googleapis.com/auth/dataportability.discover.follows`\n- `https://www.googleapis.com/auth/dataportability.discover.likes`\n- `https://www.googleapis.com/auth/dataportability.discover.not_interested`\n- `https://www.googleapis.com/auth/dataportability.maps.aliased_places`\n- `https://www.googleapis.com/auth/dataportability.maps.commute_routes`\n- `https://www.googleapis.com/auth/dataportability.maps.commute_settings`\n- `https://www.googleapis.com/auth/dataportability.maps.ev_profile`\n- `https://www.googleapis.com/auth/dataportability.maps.factual_contributions`\n- `https://www.googleapis.com/auth/dataportability.maps.offering_contributions`\n- `https://www.googleapis.com/auth/dataportability.maps.photos_videos`\n- `https://www.googleapis.com/auth/dataportability.maps.questions_answers`\n- `https://www.googleapis.com/auth/dataportability.maps.reviews`\n- `https://www.googleapis.com/auth/dataportability.maps.starred_places`\n- `https://www.googleapis.com/auth/dataportability.myactivity.maps`\n- `https://www.googleapis.com/auth/dataportability.myactivity.myadcenter`\n- `https://www.googleapis.com/auth/dataportability.myactivity.play`\n- `https://www.googleapis.com/auth/dataportability.myactivity.search`\n- `https://www.googleapis.com/auth/dataportability.myactivity.shopping`\n- `https://www.googleapis.com/auth/dataportability.myactivity.youtube`\n- `https://www.googleapis.com/auth/dataportability.mymaps.maps`\n- `https://www.googleapis.com/auth/dataportability.order_reserve.purchases_reservations`\n- `https://www.googleapis.com/auth/dataportability.play.devices`\n- `https://www.googleapis.com/auth/dataportability.play.grouping`\n- `https://www.googleapis.com/auth/dataportability.play.installs`\n- `https://www.googleapis.com/auth/dataportability.play.library`\n- `https://www.googleapis.com/auth/dataportability.play.playpoints`\n- `https://www.googleapis.com/auth/dataportability.play.promotions`\n- `https://www.googleapis.com/auth/dataportability.play.purchases`\n- `https://www.googleapis.com/auth/dataportability.play.redemptions`\n- `https://www.googleapis.com/auth/dataportability.play.subscriptions`\n- `https://www.googleapis.com/auth/dataportability.play.usersettings`\n- `https://www.googleapis.com/auth/dataportability.saved.collections`\n- `https://www.googleapis.com/auth/dataportability.search_ugc.comments`\n- `https://www.googleapis.com/auth/dataportability.search_ugc.media.reviews_and_stars`\n- `https://www.googleapis.com/auth/dataportability.search_ugc.media.streaming_video_providers`\n- `https://www.googleapis.com/auth/dataportability.search_ugc.media.thumbs`\n- `https://www.googleapis.com/auth/dataportability.search_ugc.media.watched`\n- `https://www.googleapis.com/auth/dataportability.searchnotifications.settings`\n- `https://www.googleapis.com/auth/dataportability.searchnotifications.subscriptions`\n- `https://www.googleapis.com/auth/dataportability.shopping.addresses`\n- `https://www.googleapis.com/auth/dataportability.shopping.reviews`\n- `https://www.googleapis.com/auth/dataportability.streetview.imagery`\n- `https://www.googleapis.com/auth/dataportability.youtube.channel`\n- `https://www.googleapis.com/auth/dataportability.youtube.clips`\n- `https://www.googleapis.com/auth/dataportability.youtube.comments`\n- `https://www.googleapis.com/auth/dataportability.youtube.live_chat`\n- `https://www.googleapis.com/auth/dataportability.youtube.music`\n- `https://www.googleapis.com/auth/dataportability.youtube.playable`\n- `https://www.googleapis.com/auth/dataportability.youtube.posts`\n- `https://www.googleapis.com/auth/dataportability.youtube.private_playlists`\n- `https://www.googleapis.com/auth/dataportability.youtube.private_videos`\n- `https://www.googleapis.com/auth/dataportability.youtube.public_playlists`\n- `https://www.googleapis.com/auth/dataportability.youtube.public_videos`\n- `https://www.googleapis.com/auth/dataportability.youtube.shopping`\n- `https://www.googleapis.com/auth/dataportability.youtube.subscriptions`\n- `https://www.googleapis.com/auth/dataportability.youtube.unlisted_playlists`\n- `https://www.googleapis.com/auth/dataportability.youtube.unlisted_videos`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]