- Representação JSON
- Índice
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- Promoção
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter
Entidade do pedido. Observação: 1. Todas as strings em todos os níveis devem ter menos de 1.000 caracteres, a menos que seja especificado de outra forma. 2. Todos os campos repetidos em todos os níveis precisam ter menos de 50 campos, a menos que seja especificado de outra forma. 3. Todos os carimbos de data/hora em todos os níveis, se especificados, precisam ser carimbos de data/hora válidos.
Representação JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
Campos | ||
---|---|---|
googleOrderId |
ID do pedido atribuído pelo Google. |
|
merchantOrderId |
Obrigatório: ID do pedido interno atribuído pelo comerciante. Esse ID precisa ser exclusivo e necessário para operações de atualização de pedidos subsequentes. Esse ID pode ser definido como o googleOrderId fornecido ou qualquer outro valor exclusivo. O ID apresentado aos usuários é userVisibleOrderId, que pode ser um valor diferente e mais fácil de usar. O comprimento máximo permitido é de 128 caracteres. |
|
userVisibleOrderId |
O ID do usuário que faz referência ao pedido atual. Esse ID precisa ser consistente com o ID exibido para esse pedido em outros contextos, incluindo sites, apps e e-mails. |
|
userVisibleStateLabel |
Obsoleto: use o status OrderExtensions. Marcador visível ao usuário para o estado deste pedido. |
|
buyerInfo |
informações sobre o comprador. |
|
image |
Imagem associada ao pedido. |
|
createTime |
Obrigatório: data e hora em que o pedido foi criado. É um carimbo de data/hora no formato UTC "Zulu" RFC3339, medido com precisão de nanossegundos. Exemplo: |
|
lastUpdateTime |
data e hora em que o pedido foi atualizado pela última vez. Obrigatório para OrderUpdate. É um carimbo de data/hora no formato UTC "Zulu" RFC3339, medido com precisão de nanossegundos. Exemplo: |
|
transactionMerchant |
Comerciante que facilitou a finalização da compra. Ele pode ser diferente de um provedor no nível do item de linha. Exemplo: pedido da Expedia com item de linha da ANA. |
|
contents |
Obrigatório: conteúdo do pedido, que é um grupo de itens de linha. |
|
priceAttributes[] |
Preço, descontos, impostos e assim por diante. |
|
followUpActions[] |
Ações de acompanhamento no nível do pedido. |
|
paymentData |
Dados relacionados ao pagamento do pedido. |
|
termsOfServiceUrl |
Um link para os Termos de Serviço que se aplicam ao pedido/pedido proposto. |
|
note |
Observações anexadas a um pedido. |
|
promotions[] |
Todas as promoções associadas a este pedido. |
|
disclosures[] |
Declarações associadas a este pedido. |
|
vertical |
Obsoleto: use indústrias. Essas propriedades serão aplicadas a todos os itens de linha, a menos que sejam substituídas em algum item de linha. Essa indústria precisa corresponder ao tipo de indústria no nível do item de linha. Valores possíveis: Um objeto contendo campos de um tipo arbitrário. Um campo adicional |
|
Campo de união verticals . Essas propriedades serão aplicadas a todos os itens de linha, a menos que sejam substituídas em algum item de linha. Essa indústria precisa corresponder ao tipo de indústria no nível do item de linha. verticals pode ser apenas de um dos tipos a seguir: |
||
purchase |
Ordem de compra |
|
ticket |
Pedido de passagem |
Índice
Wrapper para itens de linha.
Representação JSON | |
---|---|
{
"lineItems": [
{
object ( |
Campos | |
---|---|
lineItems[] |
Lista de itens de linha do pedido. É necessário incluir pelo menos um item de linha e, no máximo, 50. Todos os itens de linha precisam pertencer à mesma indústria. |
PaymentData
Dados de pagamento relacionados a um pedido.
Representação JSON | |
---|---|
{ "paymentResult": { object ( |
Campos | |
---|---|
paymentResult |
Resultado do pagamento usado pelo integrador para concluir uma transação. Esse campo será preenchido por ações no Google se a experiência de finalização de compra for gerenciada pela plataforma. |
paymentInfo |
Informações de pagamento sobre o pedido que sejam úteis para a interação do usuário. |
PaymentResult
Resultado de pagamento usado pelo integrador para concluir uma transação.
Representação JSON | |
---|---|
{ // Union field |
Campos | ||
---|---|---|
Campo de união result . Os dados de pagamento do Google ou a forma de pagamento do comerciante são fornecidos. result pode ser apenas de um dos tipos a seguir: |
||
googlePaymentData |
Dados da forma de pagamento fornecidos pelo Google. Caso seu processador de pagamentos esteja listado como aceito pelo Google aqui: https://developers.google.com/pay/api/, acesse o processador de pagamentos pelo link para saber mais detalhes. Caso contrário, consulte a documentação a seguir para mais detalhes sobre o payload. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
Forma de pagamento fornecida pelo comerciante/ação escolhida pelo usuário. |
PaymentInfo
Informações de pagamento relacionadas ao pedido que está sendo feito. Esse proto captura informações úteis para a interação voltada ao usuário.
Representação JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
Campos | |
---|---|
paymentMethodDisplayInfo |
As informações de exibição da forma de pagamento usada para a transação. |
paymentMethodProvenance |
Procedência da forma de pagamento usada para a transação. Talvez o usuário tenha registrado a mesma forma de pagamento no Google e no comerciante. |
PaymentMethodDisplayInfo
Resultado de pagamento usado pelo integrador para concluir uma transação.
Representação JSON | |
---|---|
{
"paymentType": enum ( |
Campos | |
---|---|
paymentType |
O tipo de pagamento. |
paymentMethodDisplayName |
Nome da forma de pagamento visível para o usuário. Por exemplo, VISA **** 1234 Conta corrente **** 5678 |
Promoção
Promoções/ofertas que foram adicionadas ao carrinho.
Representação JSON | |
---|---|
{ "coupon": string } |
Campos | |
---|---|
coupon |
Obrigatório: código do cupom aplicado a esta oferta. |
PurchaseOrderExtension
Extensão de pedido para a indústria de compras. Essas propriedades são aplicáveis a todos os itens de linha dentro do pedido, a menos que sejam substituídas em um item de linha.
Representação JSON | |
---|---|
{ "status": enum ( |
Campos | |
---|---|
status |
Obrigatório: status geral do pedido. |
userVisibleStatusLabel |
Rótulo/string visível para o usuário para o status. O comprimento máximo permitido é de 50 caracteres. |
type |
Obrigatório: tipo de compra. |
returnsInfo |
Devolver informações do pedido. |
fulfillmentInfo |
Informações de atendimento do pedido. |
extension |
Todos os campos extras trocados entre o comerciante e o Google. Um objeto contendo campos de um tipo arbitrário. Um campo adicional |
purchaseLocationType |
Local da compra (na loja / on-line) |
errors[] |
Opcional: erros que resultaram na rejeição do pedido. |
PurchaseError
Erros que podem causar rejeição de ordens de compra.
Representação JSON | |
---|---|
{ "type": enum ( |
Campos | |
---|---|
type |
Obrigatório: representa o motivo granular de um pedido ser recusado pelo comerciante. |
description |
Descrição adicional do erro. |
entityId |
ID da entidade correspondente ao erro. Exemplo que pode corresponder a OrderId / ItemOptionId. |
updatedPrice |
Relevante no caso do tipo de erro PRICE_CHANGED / INCORRECT_PRICE. |
availableQuantity |
Quantidade disponível agora. Aplicável no caso de AVAILABILITY_CHANGED. |
TicketOrderExtension
Itens para compra de ingressos, como filmes, esportes etc.
Representação JSON | |
---|---|
{
"ticketEvent": {
object ( |
Campos | |
---|---|
ticketEvent |
O evento aplicado a todos os ingressos de item de linha. |
TicketEvent
Representa um único evento.
Representação JSON | |
---|---|
{ "type": enum ( |
Campos | |
---|---|
type |
Obrigatório: tipo de evento de ingresso, por exemplo, filme, show. |
name |
Obrigatório: nome do evento. Por exemplo, se o evento for um filme, deverá ser o nome do filme. |
description |
descrição do evento. |
url |
URL para as informações do evento. |
location |
O local onde o evento vai acontecer ou a localização de uma organização. |
eventCharacters[] |
Os caracteres relacionados a este evento. Pode ser diretores ou atores de um evento cinematográfico ou artistas de um show etc. |
startDate |
Horário de início. |
endDate |
Horário de término. |
doorTime |
Horário de entrada, que pode ser diferente do horário de início do evento. Por exemplo: o evento começa às 9h, mas o horário de entrada é 8h30. |
EventCharacter
Um caractere de evento, por exemplo, organizador, artista etc.
Representação JSON | |
---|---|
{ "type": enum ( |
Campos | |
---|---|
type |
tipo do caractere de evento, por exemplo, ator ou diretor. |
name |
é o nome do personagem. |
image |
Imagens do personagem. |