Order

Entidade do pedido. Observação: 1. Todas as strings em todos os níveis precisam 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, a menos que especificado de outra forma. 3. Todos os carimbos de data/hora em todos os níveis, se especificados, precisam ser válidos.

Representação JSON
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
Campos
googleOrderId

string

ID do pedido atribuído pelo Google.

merchantOrderId

string

Obrigatório: ID do pedido interno atribuído pelo comerciante. Esse ID precisa ser exclusivo e necessário para as 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

string

O ID voltado para o usuário que faz referência ao pedido atual. Esse ID precisa ser consistente com o exibido para esse pedido em outros contextos, incluindo sites, apps e e-mail.

userVisibleStateLabel
(deprecated)

string

Obsoleto: use o status OrderExtensions. Rótulo visível ao usuário para o estado deste pedido.

buyerInfo

object (UserInfo)

informações sobre o comprador.

image

object (Image)

Imagem associada ao pedido.

createTime

string (Timestamp format)

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: "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

a data e a hora da última atualização do pedido. Obrigatório para OrderUpdate.

É um carimbo de data/hora no formato UTC "Zulu" RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

transactionMerchant

object (Merchant)

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

object (Contents)

Obrigatório: conteúdo do pedido, que é um grupo de itens de linha.

priceAttributes[]

object (PriceAttribute)

Preço, descontos, tributos e assim por diante.

followUpActions[]

object (Action)

Ações de acompanhamento no nível do pedido.

paymentData

object (PaymentData)

Dados relacionados ao pagamento do pedido.

termsOfServiceUrl

string

Um link para os Termos de Serviço que se aplicam ao pedido/pedido proposto.

note

string

Observações anexadas a um pedido.

promotions[]

object (Promotion)

Todas as promoções associadas a este pedido.

disclosures[]

object (Disclosure)

Divulgações associadas a este pedido.

vertical
(deprecated)

object

Obsoleto: use verticais. 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: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Um objeto contendo campos de um tipo arbitrário. Um campo adicional "@type" contém uma URI que identifica o tipo. Exemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.

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

object (PurchaseOrderExtension)

ordem de compra

ticket

object (TicketOrderExtension)

Pedido de ingresso

Conteúdo

Wrapper de itens de linha.

Representação JSON
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Campos
lineItems[]

object (LineItem)

Lista de itens de linha do pedido. É necessário 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 (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Campos
paymentResult

object (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 por ações no Google.

paymentInfo

object (PaymentInfo)

Informações de pagamento sobre o pedido que são úteis para a interação do usuário.

PaymentResult

Resultado do pagamento usado pelo integrador para concluir uma transação.

Representação JSON
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
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

string

Dados da forma de pagamento fornecidos pelo Google. Caso seu processador de pagamentos esteja listado como processador de pagamentos aceito pelo Google aqui: https://developers.google.com/pay/api/ Acesse seu processador de pagamentos pelo link para 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

string

Forma de pagamento fornecida pelo comerciante ou por ação escolhida pelo usuário.

PaymentInfo

Informações de pagamento sobre o pedido que está sendo feito. Esse proto captura informações úteis para a interação do usuário.

Representação JSON
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Campos
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

As informações de exibição da forma de pagamento usada para a transação.

paymentMethodProvenance

enum (PaymentMethodProvenance)

Procedência da forma de pagamento usada na transação. O usuário pode ter registrado a mesma forma de pagamento no Google e no comerciante.

PaymentMethodDisplayInfo

Resultado do pagamento usado pelo integrador para concluir uma transação.

Representação JSON
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string
}
Campos
paymentType

enum (PaymentType)

Tipo do pagamento.

paymentMethodDisplayName

string

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

string

Obrigatório: código do cupom aplicado a esta oferta.

PurchaseOrderExtension

Extensão de pedido para a indústria de compra. Essas propriedades são aplicáveis a todos os itens de linha em um pedido, a menos que sejam substituídas em um item de linha.

Representação JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
Campos
status

enum (PurchaseStatus)

Obrigatório: status geral do pedido.

userVisibleStatusLabel

string

Rótulo/string visível ao usuário para o status. O comprimento máximo permitido é de 50 caracteres.

type

enum (PurchaseType)

Obrigatório: tipo de compra.

returnsInfo

object (PurchaseReturnsInfo)

Informações de devolução do pedido.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informações de atendimento do pedido.

extension

object

Todos os campos extras trocados entre o comerciante e o Google.

Um objeto contendo campos de um tipo arbitrário. Um campo adicional "@type" contém uma URI que identifica o tipo. Exemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.

purchaseLocationType

enum (PurchaseLocationType)

Local da compra (na loja / on-line)

errors[]

object (PurchaseError)

Opcional: erros que causaram a rejeição do pedido.

PurchaseError

Erros em que uma ordem de compra pode ser rejeitada.

Representação JSON
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
Campos
type

enum (ErrorType)

Obrigatório: representa o motivo detalhado de rejeição de um pedido pelo comerciante.

description

string

Descrição adicional do erro.

entityId

string

ID da entidade que corresponde ao erro. Exemplo que pode corresponder a LineItemId / ItemOptionId.

updatedPrice

object (PriceAttribute)

Relevante em caso do tipo de erro PRICE_CHANGED / INCORRECT_PRICE.

availableQuantity

integer

Quantidade disponível agora. Aplicável em caso de AVAILABILITY_CHANGED.

TicketOrderExtension

Conteúdo do pedido de ingressos, como filmes, esportes etc.

Representação JSON
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Campos
ticketEvent

object (TicketEvent)

O evento aplicado a todos os ingressos de itens de linha.

TicketEvent

Representa um único evento.

Representação JSON
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
Campos
type

enum (Type)

Obrigatório: tipo de evento relacionado ao ingresso, por exemplo, filme ou show.

name

string

Obrigatório: nome do evento. Por exemplo, se o evento for um filme, use o nome do filme.

description

string

descrição do evento.

url

string

URL para as informações do evento.

location

object (Location)

O local onde o evento vai acontecer ou onde uma organização está localizada.

eventCharacters[]

object (EventCharacter)

Os caracteres relacionados a esse evento. Podem ser diretores ou atores de um evento de filme, artistas de um show etc.

startDate

object (Time)

Horário de início.

endDate

object (Time)

Horário de término.

doorTime

object (Time)

O horário de entrada, que pode ser diferente do horário de início, por exemplo, o evento começa às 9h, mas o horário de entrada é 8h30.

EventCharacter

Um personagem do evento, por exemplo, organizador, artista etc.

Representação JSON
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
Campos
type

enum (Type)

tipo de personagem do evento, por exemplo, ator ou diretor.

name

string

o nome do personagem.

image

object (Image)

Imagens do personagem.