Method: accounts.promotions.get

AI-generated Key Takeaways

• Retrieves a specific promotion from your Merchant Center account using its unique name.

• Requires authorization with the https://www.googleapis.com/auth/content scope.

• The request is made using an HTTP GET method to a structured URL containing the account and promotion IDs.

• After any promotion changes, it might take a few minutes for the retrieval to reflect the updates.

• The response provides a detailed representation of the promotion if the request is successful.

• HTTP request
• Path parameters
• Request body
• Response body
• Authorization scopes
• Try it!

Retrieves the promotion from your Merchant Center account.

After inserting or updating a promotion input, it may take several minutes before the updated promotion can be retrieved.

HTTP request

GET https://merchantapi.googleapis.com/promotions/v1beta/{name=accounts/*/promotions/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name	string Required. The name of the promotion to retrieve. Format: accounts/{account}/promotions/{promotions}

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Promotion.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.