Package google.shopping.merchant.lfp.v1beta

Índice

LfpInventoryService

Serviço para um parceiro do LFP enviar inventários locais para um comerciante.

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

Insere um recurso LfpInventory para a conta do comerciante de destino. Se o recurso já existir, ele será substituído. Ele expira automaticamente após 30 dias.

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.

LfpSaleService

Serviço para um parceiro do LFP enviar dados de vendas de um comerciante.

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

Insere um LfpSale para o comerciante especificado.

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.

LfpStoreService

Serviço para um parceiro do LFP enviar lojas locais para um comerciante.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

Exclui a loja de um comerciante segmentado.

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.
GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

Recupera informações sobre uma loja.

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.
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Insere uma loja para o comerciante de destino. Se a loja com o mesmo código já existir, ela será substituída.

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.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

Lista as lojas do comerciante de destino, especificadas pelo filtro em ListLfpStoresRequest.

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.

DeleteLfpStoreRequest

Mensagem de solicitação para o método DeleteLfpStore.

Campos
name

string

Obrigatório. O nome da loja a ser excluída da conta do comerciante de destino. Formato: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

Solicite mensagem para o método GetLfpStore.

Campos
name

string

Obrigatório. O nome do repositório a ser recuperado. Formato: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

Solicite mensagem para o método InsertLfpInventory.

Campos
parent

string

Obrigatório. A conta do provedor de LFP. Formato: accounts/{account}
lfp_inventory

LfpInventory

Obrigatório. O inventário a ser inserido.

InsertLfpSaleRequest

Mensagem de solicitação para o método InsertLfpSale.

Campos
parent

string

Obrigatório. A conta do provedor de LFP. Formato: accounts/{lfp_partner}
lfp_sale

LfpSale

Obrigatório. A venda a ser inserida.

InsertLfpStoreRequest

Mensagem de solicitação para o método InsertLfpStore.

Campos
parent

string

Obrigatório. Formato da conta de provedor de LFP: accounts/{account}
lfp_store

LfpStore

Obrigatório. O armazenamento a ser inserido.

LfpInventory

Inventário local do comerciante.

Campos
name

string

Apenas saída. Identificador. O nome do recurso LfpInventory. Formato: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account

int64

Obrigatório. O ID no Merchant Center do comerciante para enviar o inventário.
store_code

string

Obrigatório. O identificador da loja do comerciante. O código da loja inserido por InsertLfpStore ou o código da loja no Perfil da Empresa.
offer_id

string

Obrigatório. Imutável. Um identificador exclusivo do produto. Se os inventários e as vendas forem enviados para um comerciante, esse código precisará corresponder ao mesmo produto.

Observação: se o comerciante vender o mesmo produto novo e usado, é preciso que eles tenham códigos diferentes.
region_code

string

Obrigatório. O código de território CLDR do país onde o produto é vendido.
content_language

string

Obrigatório. O código de idioma ISO 639-1 de duas letras do item.
price

Price

Opcional. O preço atual do produto.
availability

string

Obrigatório. Disponibilidade do produto nesta loja. Para conferir os valores de atributo aceitos, consulte a especificação dos dados do inventário de produtos locais.
collection_time

Timestamp

Opcional. A hora em que o inventário é coletado. Se não for definido, ele será definido como a hora em que o inventário foi enviado.
gtin

string

Opcional. O número global do item comercial do produto.
quantity

int64

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

string

Opcional. Método de retirada aceito para esta oferta. A menos que o valor seja "indisponível", 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

Opcional. Data prevista em que um pedido estará pronto para retirada em relação à data do pedido. Ele precisa ser enviado com pickupMethod. Para conferir os valores de atributo aceitos, consulte a especificação dos dados do inventário de produtos locais.
feed_label

string

Opcional. O rótulo do feed do produto. Se esse valor não for definido, o padrão será regionCode.

LfpSale

Uma venda para o comerciante.

Campos
name

string

Apenas saída. Identificador. LfpSale: o nome do recurso. Formato: accounts/{account}/lfpSales/{sale}
target_account

int64

Obrigatório. O ID no Merchant Center do comerciante para enviar a venda.
store_code

string

Obrigatório. O identificador da loja do comerciante. Um storeCode foi inserido pela API ou pelo código da loja no Perfil da Empresa.
offer_id

string

Obrigatório. Um identificador exclusivo do produto. Se os inventários e as vendas forem enviados para um comerciante, esse código precisará corresponder ao mesmo produto.

Observação: se o comerciante vender o mesmo produto novo e usado, é preciso que eles tenham códigos diferentes.
region_code

string

Obrigatório. O código de território CLDR do país onde o produto é vendido.
content_language

string

Obrigatório. O código de idioma ISO 639-1 de duas letras do item.
gtin

string

Obrigatório. O número global do item comercial do produto vendido.
price

Price

Obrigatório. O preço unitário do produto.
quantity

int64

Obrigatório. A mudança relativa da quantidade disponível. Negativo para itens retornados.
sale_time

Timestamp

Obrigatório. O carimbo de data/hora da venda.
uid

string

Apenas saída. Um ID globalmente exclusivo gerado pelo sistema para o LfpSale.
feed_label

string

Opcional. O rótulo do feed do produto. Se esse valor não for definido, o padrão será regionCode.

LfpStore

Uma loja para o comerciante. Ele vai ser usado para corresponder a uma loja no Perfil da Empresa no Google do comerciante de destino. Se não for possível encontrar uma loja correspondente, os inventários ou vendas enviados com o código da loja não vão ser usados.

Campos
name

string

Apenas saída. Identificador. LfpStore: o nome do recurso. Formato: accounts/{account}/lfpStores/{target_merchant}~{store_code}
target_account

int64

Obrigatório. O ID do Merchant Center do comerciante para enviar a loja.
store_code

string

Obrigatório. Imutável. Um identificador da loja exclusivo para o comerciante de destino.
store_address

string

Obrigatório. O endereço da loja. Exemplo: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, EUA.
gcid_category[]

string

Opcional. ID da categoria do Google Meu Negócio.
matching_state

StoreMatchingState

Opcional. Apenas saída. O estado da correspondência com um Perfil da Empresa no Google. Consulte matchingStateHint para mais detalhes se nenhuma correspondência for encontrada.
store_name

string

Opcional. O nome do comerciante ou da loja.
phone_number

string

Opcional. O número de telefone da loja no formato E.164. Exemplo: +15556767888
website_uri

string

Opcional. O URL do site da loja ou do comerciante.
place_id

string

Opcional. O ID do lugar do Google do local da loja.
matching_state_hint

string

Opcional. Apenas saída. A dica sobre o motivo da falha na correspondência. Isso é definido apenas quando matchingState=STORE_MATCHING_STATE_FAILED.

Os valores possíveis são:

  • "linked-store-not-found": não há lojas do Perfil da Empresa no Google disponíveis para correspondência.
  • "store-match-not-found": não foi possível associar o LfpStore informado a nenhuma das lojas do Perfil da Empresa no Google conectadas. A conta do Merchant Center está conectada corretamente e as lojas estão disponíveis no Perfil da Empresa no Google, mas o endereço do local LfpStore não corresponde aos endereços das lojas no Perfil da Empresa. Atualize o endereço do LfpStore ou da loja do Perfil da Empresa no Google para corresponder corretamente.
  • "store-match-unverified": não foi possível associar o LfpStore informado a nenhuma das lojas conectadas do Perfil da Empresa no Google porque a loja correspondente não foi verificada. Siga o processo de verificação do Perfil da Empresa no Google para encontrar as informações corretas.

StoreMatchingState

O estado da correspondência de LfpStore com um Perfil da Empresa no Google.

Tipos enumerados
STORE_MATCHING_STATE_UNSPECIFIED Armazenar estado correspondente não especificado.
STORE_MATCHING_STATE_MATCHED O LfpStore corresponde a uma loja do Perfil da Empresa no Google.
STORE_MATCHING_STATE_FAILED O LfpStore não corresponde a uma loja do Perfil da Empresa no Google.

ListLfpStoresRequest

Mensagem de solicitação para o método ListLfpStores.

Campos
parent

string

Obrigatório. O parceiro do LFP. Formato: accounts/{account}
target_account

int64

Obrigatório. O ID do Merchant Center do comerciante para listar as lojas.
page_size

int32

Opcional. O número máximo de recursos LfpStore para a conta especificada retornar. O serviço vai retornar menos do que esse valor se o número de lojas da conta especificada for menor que pageSize. O valor padrão é 250. O valor máximo é 1.000. Se um valor maior que o máximo for especificado, o pageSize vai assumir o valor máximo por padrão.
page_token

string

Opcional. Um token de página recebido de uma chamada ListLfpStoresRequest anterior. Forneça o token da página para recuperar a página seguinte. Ao paginar, todos os outros parâmetros fornecidos para ListLfpStoresRequest precisam corresponder à chamada que forneceu o token da página. O token retornado como nextPageToken na resposta à solicitação anterior.

ListLfpStoresResponse

Mensagem de resposta para o método ListLfpStores.

Campos
lfp_stores[]

LfpStore

As lojas do comerciante especificado.
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.