Package google.shopping.merchant.inventories.v1beta

Índice

LocalInventoryService

Serviço para gerenciar o inventário local de produtos

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

Exclui o LocalInventory especificado do produto na sua conta de comerciante. Pode levar até uma hora para que o LocalInventory seja excluído do produto específico. Depois de receber uma resposta de exclusão, aguarde esse período antes de tentar excluir novamente.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.
InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

Insere um recurso LocalInventory em um produto na sua conta de comerciante.

Substitui o recurso LocalInventory completo se uma entrada com o mesmo storeCode já existir para o produto.

Pode levar até 30 minutos para que o recurso LocalInventory novo ou atualizado apareça nos produtos.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.
ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

Lista os recursos LocalInventory do produto na sua conta de comerciante. A resposta pode conter menos itens do que especificado por pageSize. Se pageToken foi retornado em uma solicitação anterior, ele pode ser usado para conseguir mais resultados.

Os recursos LocalInventory são listados por produto para uma determinada conta.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

RegionalInventoryService

Serviço para gerenciar o inventário regional de produtos. Há também um recurso regions e uma API separados para gerenciar definições de regiões.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Exclui o recurso RegionalInventory especificado do produto na sua conta de comerciante. Pode levar até uma hora para que o RegionalInventory seja excluído do produto específico. Depois de receber uma resposta de exclusão, aguarde esse período antes de tentar excluir novamente.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.
InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

Insere um RegionalInventory em um determinado produto na sua conta de comerciante.

Substitui o recurso RegionalInventory completo se uma entrada com o mesmo region já existir para o produto.

Pode levar até 30 minutos para que o recurso RegionalInventory novo ou atualizado apareça nos produtos.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.
ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

Lista os recursos RegionalInventory do produto na sua conta de comerciante. A resposta pode conter menos itens do que especificado por pageSize. Se pageToken foi retornado em uma solicitação anterior, ele pode ser usado para conseguir mais resultados.

Os recursos RegionalInventory são listados por produto para uma determinada conta.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

DeleteLocalInventoryRequest

Solicite mensagem para o método DeleteLocalInventory.

Campos
name

string

Obrigatório. O nome do inventário local do produto a ser excluído. Formato: accounts/{account}/products/{product}/localInventories/{store_code}

DeleteRegionalInventoryRequest

Solicite mensagem para o método DeleteRegionalInventory.

Campos
name

string

Obrigatório. O nome do recurso RegionalInventory a ser excluído. Formato: accounts/{account}/products/{product}/regionalInventories/{region}

InsertLocalInventoryRequest

Solicite mensagem para o método InsertLocalInventory.

Campos
parent

string

Obrigatório. A conta e o produto em que esse inventário será inserido. Formato: accounts/{account}/products/{product}
local_inventory

LocalInventory

Obrigatório. Informações do inventário local do produto. Se o produto já tiver um recurso LocalInventory para o mesmo storeCode, a substituição completa do recurso LocalInventory será realizada.

InsertRegionalInventoryRequest

Solicite mensagem para o método InsertRegionalInventory.

Campos
parent

string

Obrigatório. A conta e o produto em que esse inventário será inserido. Formato: accounts/{account}/products/{product}
regional_inventory

RegionalInventory

Obrigatório. Informações de inventário regional para adicionar ao produto. Se o produto já tiver um recurso RegionalInventory para o mesmo region, a substituição completa do recurso RegionalInventory será realizada.

ListLocalInventoriesRequest

Solicite mensagem para o método ListLocalInventories.

Campos
parent

string

Obrigatório. O name do produto pai para listar inventários locais. Formato: accounts/{account}/products/{product}
page_size

int32

O número máximo de recursos LocalInventory que o produto vai retornar. O serviço vai retornar um valor menor se o número de inventários do produto for menor que o pageSize. O valor padrão é 25.000. O valor máximo é 25.000. Se um valor maior que o máximo for especificado, o pageSize vai assumir o valor máximo
page_token

string

Um token de página recebido de uma chamada ListLocalInventories anterior. Forneça o token de página para recuperar a página seguinte.

Ao paginar, todos os outros parâmetros fornecidos para ListLocalInventories precisam corresponder à chamada que forneceu o token da página. O token retornado como nextPageToken na resposta à solicitação anterior.

ListLocalInventoriesResponse

Mensagem de resposta para o método ListLocalInventories.

Campos
local_inventories[]

LocalInventory

Os recursos LocalInventory do produto da conta especificada.
next_page_token

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

ListRegionalInventoriesRequest

Solicite mensagem para o método ListRegionalInventories.

Campos
parent

string

Obrigatório. O name do produto principal para listar recursos RegionalInventory. Formato: accounts/{account}/products/{product}
page_size

int32

O número máximo de recursos RegionalInventory que o produto vai retornar. O serviço vai retornar um valor menor se o número de inventários do produto for menor que o pageSize. O valor padrão é 25.000. O valor máximo é 100000. Se um valor maior que o máximo for especificado, o pageSize vai assumir o valor máximo.
page_token

string

Um token de página recebido de uma chamada ListRegionalInventories anterior. Forneça o token de página para recuperar a página seguinte.

Ao paginar, todos os outros parâmetros fornecidos para ListRegionalInventories precisam corresponder à chamada que forneceu o token da página. O token retornado como nextPageToken na resposta à solicitação anterior.

ListRegionalInventoriesResponse

Mensagem de resposta para o método ListRegionalInventories.

Campos
regional_inventories[]

RegionalInventory

Os recursos RegionalInventory do produto da conta especificada.
next_page_token

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

LocalInventory

Informações do inventário local do produto. Representa informações na loja de um produto específico na loja especificada por storeCode. Para conferir uma lista de todos os valores de atributo aceitos, consulte a especificação dos dados de inventário de produtos locais.

Campos
name

string

Apenas saída. LocalInventory: o nome do recurso. Formato: accounts/{account}/products/{product}/localInventories/{store_code}
account

int64

Apenas saída. A conta proprietária do produto. Este campo será ignorado se definido pelo cliente.
store_code

string

Obrigatório. Imutável. O código da loja (o ID da loja do seu Perfil da Empresa) da loja física em que o produto é vendido. Consulte a Especificação dos dados do inventário de produtos locais para mais informações.
price

Price

Preço do produto nessa loja.
sale_price

Price

Preço de venda do produto nesta loja. Obrigatório se salePriceEffectiveDate estiver definido.
sale_price_effective_date

Interval

O TimePeriod da venda nesta loja.
custom_attributes[]

CustomAttribute

Uma lista de atributos personalizados (fornecidos pelo comerciante). Também é possível usar CustomAttribute para enviar qualquer atributo da especificação de dados na forma genérica.
availability

string

Disponibilidade do produto na loja. Para saber quais valores de atributo são aceitos, consulte a especificação dos dados de inventário de produtos locais.
quantity

int64

Quantidade do produto disponível na loja. Precisa ser maior ou igual a zero.
pickup_method

string

Método de retirada compatível com o produto. A menos que o valor seja "not supported", esse campo precisa ser enviado com pickupSla. Para saber quais valores de atributo são aceitos, consulte a especificação dos dados de inventário de produtos locais.
pickup_sla

string

Período relativo à data em que um pedido para este produto, nesta loja, fica pronto para retirada. Precisa ser enviado com pickupMethod. Para saber quais valores de atributo são aceitos, consulte a especificação dos dados de inventário de produtos locais.
instore_product_location

string

Local do produto na loja. O comprimento máximo é de 20 bytes.

RegionalInventory

Informações regionais de inventário do produto. Representa informações específicas, como preço e disponibilidade de um determinado produto em um region específico. Para conferir uma lista de todos os valores de atributo aceitos, consulte a especificação de dados de inventário de produtos regionais.

Campos
name

string

Apenas saída. RegionalInventory: o nome do recurso. Formato: {regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}
account

int64

Apenas saída. A conta proprietária do produto. Este campo será ignorado se definido pelo cliente.
region

string

Obrigatório. Imutável. ID da região para este recurso RegionalInventory. Consulte Preços e disponibilidade regionais para mais detalhes.
price

Price

Preço do produto nessa região.
sale_price

Price

Preço de venda do produto nessa região. Obrigatório se salePriceEffectiveDate estiver definido.
sale_price_effective_date

Interval

O TimePeriod do preço de venda nessa região.
custom_attributes[]

CustomAttribute

Uma lista de atributos personalizados (fornecidos pelo comerciante). Também é possível usar CustomAttribute para enviar qualquer atributo da especificação de dados na forma genérica.
availability

string

Disponibilidade do produto nesta região. Para valores de atributos aceitos, consulte a especificação dos dados de inventário de produtos regionais.