Method: promotions.get

  • Retrieves a specific promotion from your Merchant Center account using a GET request.

  • Requires merchantId and promotion id as path parameters to identify the promotion.

  • Returns the details of the requested promotion in the response body if successful.

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

Retrieves a promotion from your Merchant Center account.

HTTP request

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions/{id}

Path parameters

Parameters
merchantId

string (int64 format)

Required. The ID of the account that contains the collection.

id

string

Required. REST ID of the promotion to retrieve.

Request body

The request body must be empty.

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the OAuth 2.0 Overview.