Merchant API (merchantapi:promotions_v1beta)

2026-11-05

3 removed methods | Removed API

Deletions

    Methods
  • ▼ ▲ merchantapi.accounts.promotions.list

      Description : Lists the promotions in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested. After inserting or updating a promotion, it may take several minutes before the updated processed promotion can be retrieved.

      Flat Path : promotions/v1beta/accounts/{accountsId}/promotions

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

      Parameter Order : parent

      HTTP Method : GET

      Parameters :

        pageSize

          Location : query

          Format : int32

          Description : Optional. The maximum number of promotions to return. The service may return fewer than this value. The maximum value is 250; values above 250 will be coerced to 250. If unspecified, the maximum number of promotions will be returned.

          Type : integer

        pageToken

          Type : string

          Description : Optional. A page token, received from a previous `ListPromotions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotions` must match the call that provided the page token.

          Location : query

        parent

          Pattern : ^accounts/[^/]+$

          Required : Yes

          Type : string

          Location : path

          Description : Required. The account to list processed promotions for. Format: `accounts/{account}`

      Path : promotions/v1beta/{+parent}/promotions

  • ▼ ▲ merchantapi.accounts.promotions.insert

      Flat Path : promotions/v1beta/accounts/{accountsId}/promotions:insert

      Path : promotions/v1beta/{+parent}/promotions:insert

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

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

      Parameter Order : parent

      HTTP Method : POST

      Parameters :

        parent

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

          Location : path

          Required : Yes

          Pattern : ^accounts/[^/]+$

          Type : string

  • ▼ ▲ merchantapi.accounts.promotions.get

      Flat Path : promotions/v1beta/accounts/{accountsId}/promotions/{promotionsId}

      Parameter Order : name

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

      HTTP Method : GET

      Parameters :

        name

          Pattern : ^accounts/[^/]+/promotions/[^/]+$

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

          Location : path

          Type : string

          Required : Yes

      Description : 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.

      Path : promotions/v1beta/{+name}