AI-generated Key Takeaways
-
This document details how to retry a failed Portability Archive job using a specific HTTP POST request.
-
The retry request requires the failed Archive job ID as a path parameter.
-
The request body for retrying a job must be empty.
-
A successful retry returns a response body containing the archiveJobId of the new job.
-
Various OAuth scopes are required for authorization to perform this action.
Retries a failed Portability Archive job.
HTTP request
POST https://dataportability.googleapis.com/v1/{name=archiveJobs/*}:retry
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
name |
Required. The Archive job ID you're retrying. This is returned by the InitiatePortabilityArchiveResponse. Retrying is only executed if the initial job failed. |
Request body
The request body must be empty.
Response body
Response from retrying a Portability Archive.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{ "archiveJobId": string } |
| Fields | |
|---|---|
archiveJobId |
The archive job ID that is initiated by the retry endpoint. This can be used to get the state of the new job. |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/dataportability.alerts.subscriptionshttps://www.googleapis.com/auth/dataportability.businessmessaging.conversationshttps://www.googleapis.com/auth/dataportability.chrome.autofillhttps://www.googleapis.com/auth/dataportability.chrome.bookmarkshttps://www.googleapis.com/auth/dataportability.chrome.dictionaryhttps://www.googleapis.com/auth/dataportability.chrome.extensionshttps://www.googleapis.com/auth/dataportability.chrome.historyhttps://www.googleapis.com/auth/dataportability.chrome.reading_listhttps://www.googleapis.com/auth/dataportability.chrome.settingshttps://www.googleapis.com/auth/dataportability.discover.followshttps://www.googleapis.com/auth/dataportability.discover.likeshttps://www.googleapis.com/auth/dataportability.discover.not_interestedhttps://www.googleapis.com/auth/dataportability.maps.aliased_placeshttps://www.googleapis.com/auth/dataportability.maps.commute_routeshttps://www.googleapis.com/auth/dataportability.maps.commute_settingshttps://www.googleapis.com/auth/dataportability.maps.ev_profilehttps://www.googleapis.com/auth/dataportability.maps.factual_contributionshttps://www.googleapis.com/auth/dataportability.maps.offering_contributionshttps://www.googleapis.com/auth/dataportability.maps.photos_videoshttps://www.googleapis.com/auth/dataportability.maps.questions_answershttps://www.googleapis.com/auth/dataportability.maps.reviewshttps://www.googleapis.com/auth/dataportability.maps.starred_placeshttps://www.googleapis.com/auth/dataportability.myactivity.mapshttps://www.googleapis.com/auth/dataportability.myactivity.myadcenterhttps://www.googleapis.com/auth/dataportability.myactivity.playhttps://www.googleapis.com/auth/dataportability.myactivity.searchhttps://www.googleapis.com/auth/dataportability.myactivity.shoppinghttps://www.googleapis.com/auth/dataportability.myactivity.youtubehttps://www.googleapis.com/auth/dataportability.mymaps.mapshttps://www.googleapis.com/auth/dataportability.order_reserve.purchases_reservationshttps://www.googleapis.com/auth/dataportability.play.deviceshttps://www.googleapis.com/auth/dataportability.play.groupinghttps://www.googleapis.com/auth/dataportability.play.installshttps://www.googleapis.com/auth/dataportability.play.libraryhttps://www.googleapis.com/auth/dataportability.play.playpointshttps://www.googleapis.com/auth/dataportability.play.promotionshttps://www.googleapis.com/auth/dataportability.play.purchaseshttps://www.googleapis.com/auth/dataportability.play.redemptionshttps://www.googleapis.com/auth/dataportability.play.subscriptionshttps://www.googleapis.com/auth/dataportability.play.usersettingshttps://www.googleapis.com/auth/dataportability.saved.collectionshttps://www.googleapis.com/auth/dataportability.search_ugc.commentshttps://www.googleapis.com/auth/dataportability.search_ugc.media.reviews_and_starshttps://www.googleapis.com/auth/dataportability.search_ugc.media.streaming_video_providershttps://www.googleapis.com/auth/dataportability.search_ugc.media.thumbshttps://www.googleapis.com/auth/dataportability.search_ugc.media.watchedhttps://www.googleapis.com/auth/dataportability.searchnotifications.settingshttps://www.googleapis.com/auth/dataportability.searchnotifications.subscriptionshttps://www.googleapis.com/auth/dataportability.shopping.addresseshttps://www.googleapis.com/auth/dataportability.shopping.reviewshttps://www.googleapis.com/auth/dataportability.streetview.imageryhttps://www.googleapis.com/auth/dataportability.youtube.channelhttps://www.googleapis.com/auth/dataportability.youtube.clipshttps://www.googleapis.com/auth/dataportability.youtube.commentshttps://www.googleapis.com/auth/dataportability.youtube.live_chathttps://www.googleapis.com/auth/dataportability.youtube.musichttps://www.googleapis.com/auth/dataportability.youtube.playablehttps://www.googleapis.com/auth/dataportability.youtube.postshttps://www.googleapis.com/auth/dataportability.youtube.private_playlistshttps://www.googleapis.com/auth/dataportability.youtube.private_videoshttps://www.googleapis.com/auth/dataportability.youtube.public_playlistshttps://www.googleapis.com/auth/dataportability.youtube.public_videoshttps://www.googleapis.com/auth/dataportability.youtube.shoppinghttps://www.googleapis.com/auth/dataportability.youtube.subscriptionshttps://www.googleapis.com/auth/dataportability.youtube.unlisted_playlistshttps://www.googleapis.com/auth/dataportability.youtube.unlisted_videos
For more information, see the OAuth 2.0 Overview.