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 de comerciante de destino especificada. Se o recurso já existir, ele será substituído. O inventário 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 uma loja de um comerciante de destino.

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 da loja a ser recuperada. 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

Solicita uma mensagem 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

Solicita uma mensagem para o método InsertLfpStore.

Campos
parent

string

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

LfpStore

Obrigatório. A loja a ser inserida.

LfpInventory

Inventário local para o 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 o qual o inventário será enviado.
store_code

string

Obrigatório. O identificador da loja do comerciante. O código da loja inserido em 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 ID precisará corresponder ao mesmo produto.

Observação: se o comerciante vender o mesmo produto novo e usado, eles precisam ter 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 do item.
price

Price

Opcional. O preço atual do produto.
availability

string

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

Timestamp

Opcional. O horário em que o inventário é coletado. Se não for definido, será definido como o horário 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 compatível com esta oferta. A menos que o valor seja "não compatível", esse campo precisa ser enviado com pickupSla. Para conferir os valores de atributo aceitos, consulte a especificação dos dados de 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. Precisa ser enviado com pickupMethod. Para ver 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 parâmetro 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 do Merchant Center do comerciante para o qual a venda será enviada.
store_code

string

Obrigatório. O identificador da loja do comerciante. Um storeCode 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 ID precisará corresponder ao mesmo produto.

Observação: se o comerciante vender o mesmo produto novo e usado, eles precisam ter 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 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 devolvidos.
sale_time

Timestamp

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

string

Apenas saída. 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 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 as vendas enviados com o código da loja não serão 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 quem a loja será enviada.
store_code

string

Obrigatório. Imutável. Um identificador de 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": a LfpStore fornecida não corresponde 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 da LfpStore não corresponde aos locais no Perfil da Empresa. Atualize o endereço da LfpStore ou da loja do Perfil da Empresa no Google para corresponder corretamente.
  • "store-match-unverified": não foi possível fazer a correspondência do LfpStore fornecido com nenhuma das lojas do Perfil da Empresa no Google conectadas, porque a loja do Perfil da Empresa no Google correspondente não foi verificada. Conclua o processo de verificação do Perfil da Empresa no Google para fazer a correspondência corretamente.

StoreMatchingState

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

Enums
STORE_MATCHING_STATE_UNSPECIFIED O estado de correspondência da loja não foi especificado.
STORE_MATCHING_STATE_MATCHED A LfpStore foi correspondida 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 no Merchant Center do comerciante para quem você quer listar as lojas.
page_size

int32

Opcional. O número máximo de recursos LfpStore que a conta vai retornar. O serviço vai retornar menos que esse valor se o número de lojas da conta 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.
page_token

string

Opcional. Um token de página recebido de uma chamada ListLfpStoresRequest anterior. Forneça o token de página para recuperar a página seguinte. Na paginação, todos os outros parâmetros enviados para ListLfpStoresRequest precisam corresponder à chamada que proporcionou 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.