Method: accounts.promotions.insert

  • Inserts a new promotion or updates an existing one for your Merchant Center account.

  • Utilizes an HTTP POST request to https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions:insert.

  • Requires specifying the parent account and providing promotion details in the request body.

  • Returns the Promotion object in the response body if the operation is successful.

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

Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.

HTTP request

POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions:insert

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The account where the promotion will be inserted. Format: accounts/{account}

Request body

The request body contains data with the following structure:

JSON representation 
{
  "promotion": {
    object (Promotion)
  },
  "dataSource": string
}
Fields
promotion

object (Promotion)

Required. The promotion to insert.
dataSource

string

Required. The data source of the promotion Format: accounts/{account}/dataSources/{datasource}.

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.