Package google.shopping.merchant.inventories.v1beta

Índice

LocalInventoryService

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

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

Exclui o LocalInventory especificado do produto fornecido na sua conta do comerciante. Pode levar até uma hora para que LocalInventory seja excluído do produto específico. Após receber uma resposta de exclusão bem-sucedida, aguarde esse período antes de tentar realizar a exclusão novamente.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

Insere um recurso LocalInventory em um produto na sua conta do 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 a Visão geral do OAuth 2.0.

ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

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

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 a Visão geral do OAuth 2.0.

RegionalInventoryService

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

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Exclui o recurso RegionalInventory especificado do produto fornecido na sua conta do comerciante. Pode levar até uma hora para que RegionalInventory seja excluído do produto específico. Após receber uma resposta de exclusão bem-sucedida, aguarde esse período antes de tentar realizar a exclusão novamente.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

Insere um RegionalInventory em um determinado produto na sua conta do 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 a Visão geral do OAuth 2.0.

ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

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

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 a Visão geral do OAuth 2.0.

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, será realizada a substituição completa do recurso LocalInventory.

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 a serem adicionadas ao produto. Se o produto já tiver um recurso RegionalInventory para o mesmo region, será realizada a substituição completa do recurso RegionalInventory.

ListLocalInventoriesRequest

Solicite mensagem para o método ListLocalInventories.

Campos
parent

string

Obrigatório. O name do produto principal em que os inventários locais serão listados. Formato: accounts/{account}/products/{product}

page_size

int32

O número máximo de recursos LocalInventory para o produto fornecido ser retornado. O serviço vai retornar menos que esse valor se o número de inventários do produto especificado 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 assumirá como padrão o máximo

page_token

string

Um token de página recebido de uma chamada ListLocalInventories anterior. Forneça o token da 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 fornecido 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 pai para listar recursos RegionalInventory. Formato: accounts/{account}/products/{product}

page_size

int32

O número máximo de recursos RegionalInventory para o produto fornecido ser retornado. O serviço vai retornar menos que esse valor se o número de inventários do produto especificado for menor que o pageSize. O valor padrão é 25.000. O valor máximo é 100.000. Se um valor maior que o máximo for especificado, o pageSize usará o máximo como padrão.

page_token

string

Um token de página recebido de uma chamada ListRegionalInventories anterior. Forneça o token da 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 fornecido 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 as informações de um produto específico na loja especificada por storeCode. Para ver uma lista de todos os valores de atributos aceitos, consulte a especificação dos dados do 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 for definido pelo cliente.

store_code

string

Obrigatório. Imutável. Código da loja (o ID que aparece no seu Perfil da Empresa) da loja física em que o produto é vendido. Consulte a especificação dos dados do inventário de produtos disponíveis na loja física para mais informações.

price

Price

Preço do produto nesta loja.

sale_price

Price

Preço promocional do produto nesta loja. Obrigatória se salePriceEffectiveDate estiver definido.

sale_price_effective_date

Interval

O TimePeriod da promoção nesta loja.

custom_attributes[]

CustomAttribute

Uma lista de atributos personalizados (fornecidos pelo comerciante). Você também pode usar CustomAttribute para enviar qualquer atributo da especificação de dados no formato genérico.

availability

string

Disponibilidade do produto nesta loja. Para conferir os valores de atributo aceitos, consulte a especificação dos dados do 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 conferir os valores de atributo aceitos, consulte a especificação dos dados do inventário de produtos locais.

pickup_sla

string

Período relativo a partir da data do pedido para que um produto desta loja esteja pronto para retirada. Precisa ser enviado com pickupMethod. Para conferir os valores de atributo aceitos, consulte a especificação dos dados do inventário de produtos locais.

instore_product_location

string

Localização do produto dentro da loja. O tamanho máximo é de 20 bytes.

RegionalInventory

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

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 for definido pelo cliente.

region

string

Obrigatório. Imutável. ID da região para este recurso RegionalInventory. Consulte Disponibilidade e preços regionais para saber mais.

price

Price

Preço do produto nesta região.

sale_price

Price

Preço promocional do produto na região. Obrigatória se salePriceEffectiveDate estiver definido.

sale_price_effective_date

Interval

O TimePeriod do preço promocional na região.

custom_attributes[]

CustomAttribute

Uma lista de atributos personalizados (fornecidos pelo comerciante). Você também pode usar CustomAttribute para enviar qualquer atributo da especificação de dados no formato genérico.

availability

string

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