Merchant API (merchantapi:inventories_v1beta)

2024-06-14

6 new methods | New API

Additions

    Methods
  • merchantapi.accounts.products.localInventories.list

      Path : inventories/v1beta/{+parent}/localInventories

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

      HTTP Method : GET

      Parameters :

        parent

          Description : Required. The `name` of the parent product to list local inventories for. Format: `accounts/{account}/products/{product}`

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

          Location : path

          Required : Yes

          Type : string

        pageSize

          Description : The maximum number of `LocalInventory` resources for the given product to return. The service returns fewer than this value if the number of inventories for the given product is less that than the `pageSize`. The default value is 25000. The maximum value is 25000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum

          Location : query

          Type : integer

          Format : int32

        pageToken

          Description : A page token, received from a previous `ListLocalInventories` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListLocalInventories` must match the call that provided the page token. The token returned as nextPageToken in the response to the previous request.

          Location : query

          Type : string

      Parameter Order : parent

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

      Description : Lists the `LocalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `LocalInventory` resources are listed per product for a given account.

  • merchantapi.accounts.products.localInventories.insert

      Path : inventories/v1beta/{+parent}/localInventories:insert

      Flat Path : inventories/v1beta/accounts/{accountsId}/products/{productsId}/localInventories:insert

      HTTP Method : POST

      Parameters :

        parent

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

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

          Location : path

          Required : Yes

          Type : string

      Parameter Order : parent

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

      Description : Inserts a `LocalInventory` resource to a product in your merchant account. Replaces the full `LocalInventory` resource if an entry with the same `storeCode` already exists for the product. It might take up to 30 minutes for the new or updated `LocalInventory` resource to appear in products.

  • merchantapi.accounts.products.localInventories.delete

      Path : inventories/v1beta/{+name}

      Flat Path : inventories/v1beta/accounts/{accountsId}/products/{productsId}/localInventories/{localInventoriesId}

      HTTP Method : DELETE

      Parameters :

        name

          Description : Required. The name of the local inventory for the given product to delete. Format: `accounts/{account}/products/{product}/localInventories/{store_code}`

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

          Location : path

          Required : Yes

          Type : string

      Parameter Order : name

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

      Description : Deletes the specified `LocalInventory` from the given product in your merchant account. It might take a up to an hour for the `LocalInventory` to be deleted from the specific product. Once you have received a successful delete response, wait for that period before attempting a delete again.

  • merchantapi.accounts.products.regionalInventories.list

      Path : inventories/v1beta/{+parent}/regionalInventories

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

      HTTP Method : GET

      Parameters :

        parent

          Description : Required. The `name` of the parent product to list `RegionalInventory` resources for. Format: `accounts/{account}/products/{product}`

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

          Location : path

          Required : Yes

          Type : string

        pageSize

          Description : The maximum number of `RegionalInventory` resources for the given product to return. The service returns fewer than this value if the number of inventories for the given product is less that than the `pageSize`. The default value is 25000. The maximum value is 100000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum.

          Location : query

          Type : integer

          Format : int32

        pageToken

          Description : A page token, received from a previous `ListRegionalInventories` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListRegionalInventories` must match the call that provided the page token. The token returned as nextPageToken in the response to the previous request.

          Location : query

          Type : string

      Parameter Order : parent

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

      Description : Lists the `RegionalInventory` resources for the given product in your merchant account. The response might contain fewer items than specified by `pageSize`. If `pageToken` was returned in previous request, it can be used to obtain additional results. `RegionalInventory` resources are listed per product for a given account.

  • merchantapi.accounts.products.regionalInventories.insert

      Path : inventories/v1beta/{+parent}/regionalInventories:insert

      Flat Path : inventories/v1beta/accounts/{accountsId}/products/{productsId}/regionalInventories:insert

      HTTP Method : POST

      Parameters :

        parent

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

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

          Location : path

          Required : Yes

          Type : string

      Parameter Order : parent

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

      Description : Inserts a `RegionalInventory` to a given product in your merchant account. Replaces the full `RegionalInventory` resource if an entry with the same `region` already exists for the product. It might take up to 30 minutes for the new or updated `RegionalInventory` resource to appear in products.

  • merchantapi.accounts.products.regionalInventories.delete

      Path : inventories/v1beta/{+name}

      Flat Path : inventories/v1beta/accounts/{accountsId}/products/{productsId}/regionalInventories/{regionalInventoriesId}

      HTTP Method : DELETE

      Parameters :

        name

          Description : Required. The name of the `RegionalInventory` resource to delete. Format: `accounts/{account}/products/{product}/regionalInventories/{region}`

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

          Location : path

          Required : Yes

          Type : string

      Parameter Order : name

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

      Description : Deletes the specified `RegionalInventory` resource from the given product in your merchant account. It might take up to an hour for the `RegionalInventory` to be deleted from the specific product. Once you have received a successful delete response, wait for that period before attempting a delete again.