Merchant API (merchantapi:products_v1beta)

2024-06-14

4 new methods | New API

Additions

    Methods
  • merchantapi.accounts.productInputs.insert

      Path: products/v1beta/{+parent}/productInputs:insert

      Flat Path: products/v1beta/accounts/{accountsId}/productInputs:insert

      HTTP Method: POST

      Parameters:

        parent

          Description: Required. The account where this product will be inserted. Format: accounts/{account}

          Pattern: ^accounts/[^/]+$

          Location: path

          Required: Yes

          Type: string

        dataSource

          Description: Required. The primary or supplemental product data source name. If the product already exists and data source provided is different, then the product will be moved to a new data source. Format: `accounts/{account}/dataSources/{datasource}`.

          Location: query

          Type: string

      Parameter Order: parent

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

      Description: Uploads a product input to your Merchant Center account. If an input with the same contentLanguage, offerId, and dataSource already exists, this method replaces that entry. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.

  • merchantapi.accounts.productInputs.delete

      Path: products/v1beta/{+name}

      Flat Path: products/v1beta/accounts/{accountsId}/productInputs/{productInputsId}

      HTTP Method: DELETE

      Parameters:

        name

          Description: Required. The name of the product input resource to delete. Format: accounts/{account}/productInputs/{product}

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

          Location: path

          Required: Yes

          Type: string

        dataSource

          Description: Required. The primary or supplemental data source from which the product input should be deleted. Format: `accounts/{account}/dataSources/{datasource}`.

          Location: query

          Type: string

      Parameter Order: name

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

      Description: Deletes a product input from your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.

  • merchantapi.accounts.products.get

      Path: products/v1beta/{+name}

      Flat Path: products/v1beta/accounts/{accountsId}/products/{productsId}

      HTTP Method: GET

      Parameters:

        name

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

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

          Location: path

          Required: Yes

          Type: string

      Parameter Order: name

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

      Description: Retrieves the processed product from your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the updated final product can be retrieved.

  • merchantapi.accounts.products.list

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

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

      HTTP Method: GET

      Parameters:

        parent

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

          Pattern: ^accounts/[^/]+$

          Location: path

          Required: Yes

          Type: string

        pageSize

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

          Location: query

          Type: integer

          Format: int32

        pageToken

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

          Location: query

          Type: string

      Parameter Order: parent

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

      Description: Lists the processed products 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, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved.