Order

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 (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 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 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
(deprecated)

string

Obsoleto: use o status OrderExtensions. Marcador 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)

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: "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, impostos 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)

Declarações associadas a este pedido.

vertical
(deprecated)

object

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: 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 passagem

UserInfo

Informações sobre o usuário. É usado para representar informações do usuário associado a um pedido.

Representação JSON
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
Campos
email

string

E-mail do usuário, por exemplo: janedoe@gmail.com.

firstName

string

Nome do usuário.

lastName

string

Sobrenome do usuário.

displayName

string

O nome de exibição do usuário pode ser diferente do nome ou sobrenome.

phoneNumbers[]

object (PhoneNumber)

Números de telefone do usuário.

PhoneNumber

Representação padrão de número de telefone.

Representação JSON
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
Campos
e164PhoneNumber

string

Número de telefone no formato E.164, conforme definido na Recomendação E.164 da União Internacional de Telecomunicações (ITU). link da Wikipédia: https://en.wikipedia.org/wiki/E.164

extension

string

O ramal não é padronizado nas recomendações do ITU, exceto por ser definido como uma série de números com comprimento máximo de 40 dígitos. Ela é definida aqui como uma string para acomodar o possível uso de um zero inicial na extensão (as organizações têm total liberdade para fazer isso, pois não há um padrão definido). Além de dígitos, alguns outros caracteres de discagem, como "," (indicando uma espera) podem ser armazenadas aqui. Por exemplo, no ramal xxx-xxx-xxxx 123, "123" é a extensão.

preferredDomesticCarrierCode

string

O código de seleção da operadora preferencial ao ligar para esse número de telefone localmente. Isso também inclui códigos que precisam ser discados em alguns países ao ligar de telefones fixos para dispositivos móveis ou vice-versa. Por exemplo, em Colúmbia, um "3" precisa ser discado antes do próprio número de telefone ao chamar de um telefone celular para um telefone fixo doméstico e vice-versa. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Esta é a configuração preferencial o que significa que outros códigos também podem funcionar.

Imagem

Uma imagem exibida no card.

Representação JSON
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
Campos
url

string

O URL de origem da imagem. As imagens podem ser JPG, PNG e GIF (animadas ou não). Por exemplo,https://www.agentx.com/logo.png. Obrigatório.

accessibilityText

string

Uma descrição de texto da imagem a ser usada para acessibilidade, por exemplo, e leitores de tela. Obrigatório.

height

number

A altura da imagem, em pixels. Opcional.

width

number

A largura da imagem, em pixels. Opcional.

Comerciante

Comerciante do carrinho/pedido/item de linha.

Representação JSON
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
Campos
id

string

ID opcional atribuído ao comerciante, se houver.

name

string

O nome do comerciante, como "Panera Bread".

image

object (Image)

A imagem associada ao comerciante.

phoneNumbers[]

object (PhoneNumber)

Números de telefone do comerciante.

address

object (Location)

Endereço do comerciante.

Local

Contêiner que representa um local.

Representação JSON
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
Campos
coordinates

object (LatLng)

Coordenadas geográficas. Requer o dispositivo [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

formattedAddress

string

Endereço de exibição, por exemplo, "1600 Amphitheatre Parkway, Mountain View, CA 94043". Requer o dispositivo [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

zipCode

string

CEP. Requer o dispositivo [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] ou [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

city

string

Cidade Requer o dispositivo [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] ou [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

postalAddress

object (PostalAddress)

Endereço postal. Requer o dispositivo [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] ou [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

name

string

Nome do lugar.

phoneNumber

string

Número de telefone do local, por exemplo, número de contato do local da empresa ou número de telefone do local de entrega.

notes

string

Observações sobre o local.

placeId

string

placeId é usado com a API Places para buscar detalhes de um local. Consulte https://developers.google.com/places/web-service/place-id

LatLng

Um objeto que representa um par de latitude/longitude. Ele é expresso como um par de valores duplos que representam graus de latitude e longitude. Salvo indicação em contrário, ele precisa estar em conformidade com o padrão WGS84. Os valores precisam estar dentro de intervalos normalizados.

Representação JSON
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].

longitude

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

PostalAddress

Representa um endereço postal, por exemplo, para endereços para pagamento ou distribuição postal. Com um endereço postal, o serviço de correios pode entregar itens em um local, uma caixa postal ou outro local semelhante. Não se destina a modelar locais geográficos (estradas, cidades, montanhas).

No uso normal, um endereço seria criado por digitação do usuário ou pela importação de dados existentes, dependendo do tipo de processo.

Dicas sobre inserção / edição de endereços: - Use um widget de endereço pronto para i18n, como https://github.com/google/libaddressinput. - Os usuários não devem receber elementos da interface para entrada ou edição de campos fora dos países onde esse campo é usado.

Para mais orientações sobre como usar este esquema, consulte: https://support.google.com/business/answer/6397478.

Representação JSON
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Campos
revision

number

A revisão de esquema do PostalAddress. Precisa ser definido como 0, que é a revisão mais recente.

Todas as novas revisões precisam ser compatíveis com versões anteriores.

regionCode

string

Obrigatório. Código de região CLDR do país/região do endereço. Nunca é inferido e cabe ao usuário garantir que o valor esteja correto. Para mais detalhes, consulte http://cldr.unicode.org/ e http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemplo: "CH" para a Suíça.

languageCode

string

Opcional. Código de idioma BCP-47 do conteúdo deste endereço (se conhecido). Costuma ser o idioma da IU do formulário de entrada ou espera-se que corresponda a um dos idiomas usados no país/região do endereço ou nos equivalentes transliterados dele. Pode afetar a formatação em determinados países, mas não é fundamental para a exatidão dos dados e nunca afetará a validação ou outras operações relacionadas à não formatação.

Se você não conhece o valor, omita-o (em vez de especificar um padrão possivelmente incorreto).

Exemplos: "zh-Hant", "ja", "ja-latn", "pt".

postalCode

string

Opcional. Código postal do endereço. Nem todos os países usam ou exigem códigos postais, mas nos locais onde são usados, eles podem desencadear uma validação adicional com outras partes do endereço (por exemplo, validação de estado/CEP nos EUA).

sortingCode

string

Opcional. Código de classificação adicional específico de país. Não é usado na maioria das regiões. Nos locais em que é usado, o valor é uma string como “CEDEX”, que pode ser seguida por um número (por exemplo, “CEDEX 7”), ou apenas um número sozinho, representando o “código do setor” (Jamaica), o “indicador de área de entrega” (Malawi) ou o “indicador de agência de correio” (por exemplo, Costa do Marfim).

administrativeArea

string

Opcional. A maior subdivisão administrativa que é usada para endereços postais de um país ou uma região. Por exemplo, pode ser um estado, uma província, uma zona ou uma prefeitura. Especificamente na Espanha, é a província, e não a comunidade autônoma (por exemplo, “Barcelona”, não “Catalunha”). Muitos países não usam área administrativa em endereços postais. Por exemplo, na Suíça, isso deve ser deixado em branco.

locality

string

Opcional. Geralmente se refere à parte do endereço relativa a cidade/município. Exemplos: cidade nos EUA, comunidade na Itália, distrito postal no Reino Unido. Em regiões onde as localidades não são claramente definidas ou não se encaixam bem nessa estrutura, deixe a localidade em branco e use addressLines.

sublocality

string

Opcional. Sublocalidade do endereço. Por exemplo, pode ser bairro ou distrito.

addressLines[]

string

Linhas de endereço não estruturadas que descrevem os níveis mais detalhados de um endereço.

Como os valores em addressLines não têm informações de tipo e podem conter diversos valores em um único campo (por exemplo, “Austin, TX”), é importante que a ordem da linha seja clara. Ela precisa estar em “ordem de envelope” em país ou região do endereço. Em locais em que isso pode variar (por exemplo, Japão), address_language é usado para explicitar (por exemplo, "ja" para ordem do maior para o menor e "ja-Latn" ou "pt" para ordem do menor para o maior). Desta forma, a linha mais específica de um endereço pode ser selecionada com base no idioma.

A representação estrutural mínima permitida de um endereço consiste em um regionCode com todas as informações restantes colocadas em addressLines. Seria possível formatar esse endereço sem geocodificação, mas nenhum raciocínio semântico poderia ser feito sobre qualquer um dos componentes do endereço até que ele fosse pelo menos parcialmente resolvido.

Criar um endereço que apresente apenas um regionCode e addressLines e depois geocodificar é a maneira recomendada de lidar com endereços completamente não estruturados (em vez de adivinhar quais partes do endereço devem ser localidades ou áreas administrativas).

recipients[]

string

Opcional. O destinatário no endereço. Sob certas circunstâncias, este campo pode conter informações em várias linhas. Por exemplo, informações sobre cuidados.

organization

string

Opcional. O nome da organização no endereço.

Índice

Wrapper para itens de linha.

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

object (LineItem)

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.

LineItem

Um item de linha contém uma indústria. Um pedido ou carrinho pode ter vários itens de linha da mesma indústria. Os itens de sublinha/complementos etc. precisam ser definidos em protótipos verticais, dependendo dos casos de uso. 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
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
Campos
id

string

Obrigatório: identificador atribuído pelo comerciante para o item de linha. Usado para identificar itens de linha existentes ao aplicar atualizações parciais. O comprimento máximo permitido é de 64 caracteres.

name

string

Nome do item de linha conforme exibido no recibo. O comprimento máximo permitido é de 100 caracteres.

userVisibleStateLabel
(deprecated)

string

Obsoleto. Use o status de nível vertical. Por exemplo, para compras, use PurchaseOrderExtension.status. Rótulo visível para o usuário para o estado deste item de linha.

provider

object (Merchant)

O fornecedor do item de linha específico, se for diferente do pedido geral. Exemplo: pedido da Expedia com o provedor de itens de linha ANA.

priceAttributes[]

object (PriceAttribute)

Preço e ajustes no nível do item de linha.

followUpActions[]

object (Action)

Ações de acompanhamento no item de linha.

recipients[]

object (UserInfo)

Clientes no nível do item de linha, que pode ser diferente do comprador no nível do pedido. Exemplo: o usuário X fez uma reserva em um restaurante com o nome do usuário Y.

image

object (Image)

Imagem pequena associada a este item, se houver.

description

string

Descrição do item de linha.

notes[]

string

Outras observações aplicáveis a este item de linha específico, como a política de cancelamento.

disclosures[]

object (Disclosure)

Divulgações associadas a este item de linha.

vertical
(deprecated)

object

Obsoleto: use indústrias. Obrigatório: conteúdo semântico do item de linha com base no tipo/indústria. Cada indústria deve incluir os próprios detalhes de atendimento. Precisa ser um destes valores: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

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. Obrigatório: conteúdo semântico do item de linha com base no tipo/indústria. Cada indústria deve incluir os próprios detalhes de atendimento. verticals pode ser apenas de um dos tipos a seguir:
purchase

object (PurchaseItemExtension)

Ordens de compra, como mercadorias, comida etc.

reservation

object (ReservationItemExtension)

Pedidos de reserva, como restaurante, corte de cabelo etc.

PriceAttribute

Atributo de preço de um pedido ou item de linha.

Representação JSON
{
  "type": enum (Type),
  "name": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": number
  // End of list of possible types for union field spec.
}
Campos
type

enum (Type)

Obrigatório: atributo tipo de dinheiro.

name

string

Obrigatório: string do atributo de preço exibida pelo usuário. Ele é enviado e localizado pelo comerciante.

state

enum (State)

Obrigatório: estado do preço: estimativa x real.

taxIncluded

boolean

Se o preço inclui tributos.

Campo de união spec. Representa o valor monetário ou a porcentagem em milissegundos. spec pode ser apenas de um dos tipos a seguir:
amount

object (Money)

Valor monetário.

amountMillipercentage
(deprecated)

number

A especificação de porcentagem para 1/1.000 de um percentual. Por exemplo: 8,750% é representado como 8.750, e as porcentagens negativas representam descontos percentuais. Suspensão do uso deste campo. Pode considerar adicionar novamente quando um caso de uso sólido for necessário.

Tipo

Representa o tipo de dinheiro.

Enums
TYPE_UNSPECIFIED O tipo não está especificado. Os clientes não devem precisar definir isso explicitamente.
REGULAR Preço de exibição normal, antes da aplicação de qualquer desconto.
DISCOUNT A ser subtraído do subtotal.
TAX A ser adicionado ao subtotal.
DELIVERY A ser adicionado ao subtotal.
SUBTOTAL Subtotal antes que algumas taxas sejam adicionadas.
FEE Qualquer taxa adicional.
GRATUITY A ser adicionado ao subtotal.
TOTAL Preço do pedido ou item de linha exibido.

Estado

Representa o estado do preço.

Enums
STATE_UNSPECIFIED Não especificado.
ESTIMATE O preço é apenas uma estimativa.
ACTUAL Preço real que será cobrado do usuário.

Dinheiro

Representa um montante em dinheiro com o respectivo tipo de moeda.

Representação JSON
{
  "currencyCode": string,
  "amountInMicros": string
}
Campos
currencyCode

string

O código de moeda de três letras definido no ISO 4217.

amountInMicros

string (int64 format)

Quantia em micros. Por exemplo, este campo deve ser definido como 1990000 por US $1,99.

Ação

Uma ação de acompanhamento associada ao pedido ou item de linha.

Representação JSON
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
Campos
type

enum (Type)

Obrigatório: tipo de ação.

title

string

Título ou rótulo da ação, exibido para o usuário. O comprimento máximo permitido é de 100 caracteres.

openUrlAction

object (OpenUrlAction)

O que fazer.

actionMetadata

object (ActionMetadata)

Metadados associados a uma ação.

Tipo

Possíveis ações de acompanhamento.

Enums
TYPE_UNSPECIFIED Ação não especificada.
VIEW_DETAILS Ação "Ver detalhes do pedido".
MODIFY Modificar ação do pedido.
CANCEL Cancelar ação do pedido.
RETURN Ação de pedido de devolução.
EXCHANGE Ação de pedido de troca.
EMAIL

Ação de e-mail. Os tipos EMAIL e CALL foram descontinuados. O openUrlAction.url pode ser usado como um número de telefone ou um e-mail.

CALL

Ação de chamada.

REORDER Ação de reordenar
REVIEW Revise a ação do pedido.
CUSTOMER_SERVICE Entre em contato com o atendimento ao cliente.
FIX_ISSUE Direto ao site ou app do comerciante para corrigir o problema.
DIRECTION Link da rota.

OpenUrlAction

Abre o URL fornecido.

Representação JSON
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
Campos
url

string

O campo do URL, que pode ser qualquer um destes: URLs http/https para abrir um app vinculado a um app ou uma página da Web

androidApp

object (AndroidApp)

Informações sobre o app Android se o URL for atendido por um app Android.

urlTypeHint

enum (UrlTypeHint)

Indica uma dica para o tipo de URL.

AndroidApp

Especificação do app Android para restrições de fulfillment

Representação JSON
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
Campos
packageName

string

Nome do pacote O nome do pacote precisa ser especificado ao especificar o Android Fulfillment.

versions[]

object (VersionFilter)

Quando vários filtros são especificados, qualquer correspondência de filtro aciona o aplicativo.

VersionFilter

O VersionFilter vai precisar ser incluído se versões específicas do app forem necessárias.

Representação JSON
{
  "minVersion": number,
  "maxVersion": number
}
Campos
minVersion

number

Código de versão mínima ou 0, inclusive.

maxVersion

number

Código de versão máxima (inclusive). O intervalo considerado é [minVersion:maxVersion]. Um intervalo nulo implica qualquer versão. Exemplos: para especificar uma única versão, use [target_version:target_version]. Para especificar qualquer versão, deixe minVersion e maxVersion não especificados. Para especificar todas as versões até maxVersion, deixe minVersion não especificado. Para especificar todas as versões de minVersion, deixe maxVersion não especificado.

UrlTypeHint

Diferentes tipos de dicas de URL.

Enums
URL_TYPE_HINT_UNSPECIFIED Não especificado
AMP_CONTENT É o URL que leva diretamente ao conteúdo AMP ou a um URL canônico que se refere ao conteúdo AMP por meio de <link rel="amphtml">.

ActionMetadata

Metadados relacionados por ação.

Representação JSON
{
  "expireTime": string
}
Campos
expireTime

string (Timestamp format)

Horário em que esta ação vai expirar.

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

Divulgação

Uma divulgação de produto, serviço ou política que pode ser apresentada ao usuário.

Representação JSON
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
Campos
title

string

Título da divulgação. Exemplo: "Informações de segurança".

disclosureText

object (DisclosureText)

Conteúdo da divulgação. Links da Web são permitidos.

presentationOptions

object (DisclosurePresentationOptions)

Opções de apresentação para a declaração.

DisclosureText

Representa um texto simples com links da Web.

Representação JSON
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
Campos
template

string

Texto a ser exibido, contendo espaços reservados como "{0}" e “{1}” para cada link de texto que deve ser inserido. Exemplo: "AVISO: este produto pode expor você a substâncias químicas que são conhecidas pelo Estado da Califórnia como responsáveis por causar câncer. Para obter mais informações, acesse {0}." Esse texto de declaração não pode incluir conteúdo promocional ou semelhante a anúncios.

DisclosurePresentationOptions

Opções para a apresentação de uma declaração.

Representação JSON
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
Campos
presentationRequirement

enum (PresentationRequirement)

Requisitos de apresentação da divulgação.

initiallyExpanded

boolean

Se o conteúdo da declaração deve ser inicialmente expandido. Por padrão, ele fica recolhido inicialmente.

PresentationRequirement

Exigência para a apresentação da divulgação.

Enums
REQUIREMENT_UNSPECIFIED Requisito não especificado. Não deve definir isso explicitamente.
REQUIREMENT_OPTIONAL A declaração é opcional. Ele poderá ser ignorado se o dispositivo não for compatível com a exibição de declarações.
REQUIREMENT_REQUIRED A declaração é obrigatória. A conversa será enviada para o telefone se o dispositivo não for compatível com a exibição de divulgações.

PurchaseItemExtension

Conteúdo do item de linha da indústria de compra.

Representação JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": number,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
Campos
status

enum (PurchaseStatus)

Obrigatório: status no nível do item de linha.

userVisibleStatusLabel

string

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

type

enum (PurchaseType)

Obrigatório: tipo de compra.

productId
(deprecated)

string

ID do produto ou da oferta associada a este item de linha.

quantity

number

Quantidade do item.

unitMeasure

object (MerchantUnitMeasure)

Unidade de medida. Especifica o tamanho do item nas unidades escolhidas. O tamanho e o preço ativo são usados para determinar o preço unitário.

returnsInfo

object (PurchaseReturnsInfo)

Retorna as informações deste item de linha. Se não for definido, o item de linha herdará informações de retorno no nível do pedido.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informações de fulfillment para este item de linha. Se não for definido, o item de linha herdará informações de atendimento no nível do pedido.

itemOptions[]

object (ItemOption)

Outros complementos ou subitens.

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" }.

productDetails

object (ProductDetails)

Detalhes sobre o produto.

PurchaseStatus

É o status de compra associado a uma ordem de compra ou a um item de linha específico.

Enums
PURCHASE_STATUS_UNSPECIFIED Status não especificado.
READY_FOR_PICKUP Pronto para retirada.
SHIPPED Enviado.
DELIVERED Entregue.
OUT_OF_STOCK Esgotado.
IN_PREPARATION IN_PREPARATION podem ter significados diferentes dependendo do contexto. Para pedidos de COMIDA, pode ser que a comida esteja sendo preparada. Para o varejo, pode ser um item que está sendo embalado.
CREATED O pedido é criado.
CONFIRMED O comerciante confirmou o pedido.
REJECTED O comerciante rejeitou o pedido ou o item de linha.
RETURNED O item foi devolvido pelo usuário.
CANCELLED O pedido ou item de linha foi cancelado pelo usuário.
CHANGE_REQUESTED O usuário solicitou uma alteração no pedido, e o integrador está processando essa alteração. O pedido deve ser movido para outro estado após o processamento da solicitação.

PurchaseType

A categoria de compra.

Enums
PURCHASE_TYPE_UNSPECIFIED Valor desconhecido.
RETAIL Inclui compras como produtos físicos.
FOOD Inclui a compra de pedidos de comida.
GROCERY Compra de mercado.
MOBILE_RECHARGE Compra de recarga de celular pré-paga.

MerchantUnitMeasure

Medida de preço unitário do comerciante.

Representação JSON
{
  "measure": number,
  "unit": enum (Unit)
}
Campos
measure

number

Valor: exemplo 1.2.

unit

enum (Unit)

Unidade: exemplo POUND, GRAM.

Unidade

Enums
UNIT_UNSPECIFIED Unidade não especificada.
MILLIGRAM Miligrama.
GRAM Vovó
KILOGRAM Quilograma.
OUNCE Onça.
POUND Libra.

PurchaseReturnsInfo

Retorna informações associadas a um pedido ou a um item de linha específico.

Representação JSON
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
Campos
isReturnable

boolean

Se verdadeiro, o retorno é permitido.

daysToReturn

number

A devolução é permitida dentro do prazo especificado.

policyUrl

string

Link para a política de devolução.

PurchaseFulfillmentInfo

Informações de atendimento associadas a uma ordem de compra ou a um item de linha específico.

Representação JSON
{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}
Campos
id

string

Identificador exclusivo dessa opção de serviço.

fulfillmentType

enum (Type)

Obrigatório: o tipo de fulfillment.

expectedFulfillmentTime

object (Time)

Uma janela se um intervalo de tempo for especificado ou um ETA se um único horário for especificado. Horário esperado de entrega ou retirada.

expectedPreparationTime

object (Time)

Uma janela se um intervalo de tempo for especificado ou um ETA se um único horário for especificado. Tempo esperado para preparar a comida. Preferência para uso único.

location

object (Location)

Local de retirada ou entrega.

expireTime

string (Timestamp format)

Horário em que essa opção de atendimento do pedido expira.

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

price

object (PriceAttribute)

Custo dessa opção.

fulfillmentContact

object (UserInfo)

Contato do usuário para esse fulfillment.

shippingMethodName

string

Nome do método de envio selecionado pelo usuário.

storeCode

string

StoreCode do local. Exemplo: Walmart é o comerciante, e storeCode é a loja Walmart onde o atendimento ocorreu. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

Informações adicionais sobre como o pedido seria selecionado. Esse campo só é aplicável quando o tipo de atendimento do pedido é "RETIRADA".

Tipo

Tipo de fulfillment.

Enums
TYPE_UNSPECIFIED Tipo não especificado.
DELIVERY Este pedido será entregue.
PICKUP Este pedido precisa ser retirado.

Tempo

A construção de tempo para representar o tempo de um evento a ser usado ao exibir um pedido ao usuário.

Representação JSON
{
  "timeIso8601": string
}
Campos
timeIso8601

string

Representa um horário de evento do pedido, como horário de reserva, horário de entrega e assim por diante. Pode ser uma duração (horário de início e término), apenas a data, data e hora etc. Consulte https://en.wikipedia.org/wiki/ISO_8601 para ver todos os formatos compatíveis.

PickupInfo

Detalhes sobre como um pedido é retirado. Ele inclui detalhes como o tipo de retirada e metadados adicionais anexados a cada tipo, se houver.

Representação JSON
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
Campos
pickupType

enum (PickupType)

Método de retirada, como INSTORE, CURBSIDE etc.

curbsideInfo

object (CurbsideInfo)

Detalhes específicos das informações de drive-thru. Se pickupType não for "CURBSIDE", este campo será ignorado.

checkInInfo[]

object (CheckInInfo)

Lista de vários métodos aceitos pelo parceiro para permitir o check-in.

PickupType

Lista de tipos de retirada aceitos.

Enums
UNSPECIFIED Tipo de retirada não especificado.
INSTORE Retirar comida dentro do restaurante.
CURBSIDE Estacione o veículo em um local designado fora do restaurante e alguém vai entregar a comida lá.

CurbsideInfo

Detalhes sobre como seria facilitada a ordem de drive-thru.

Representação JSON
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
Campos
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

Os parceiros precisam de mais informações para facilitar os pedidos para retirada na porta. Dependendo do tipo de atendimento escolhido, os detalhes correspondentes serão coletados do usuário.

userVehicle

object (Vehicle)

Detalhes do veículo do usuário que fez o pedido.

CurbsideFulfillmentType

Possíveis valores dos tipos de atendimento por drive-thru.

Enums
UNSPECIFIED Tipo de processamento do pedido de drive-thru não especificado.
VEHICLE_DETAIL Detalhes do veículo necessários para facilitar a retirada na porta.

Veículo

Detalhes sobre um veículo

Representação JSON
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
Campos
make

string

Marca do veículo (por exemplo, "Honda"). Ele é exibido para o usuário e precisa ser localizado. Obrigatório.

model

string

Modelo do veículo (por exemplo, "Grom"). Ele é exibido para o usuário e precisa ser localizado. Obrigatório.

licensePlate

string

Número da placa do veículo (por exemplo, "1ABC234"). Obrigatório.

colorName

string

Nome da cor do veículo, por exemplo preto Opcional.

image

object (Image)

URL para uma foto do veículo. A foto será exibida com aproximadamente 256 x 256 px. Precisa ser um arquivo jpg ou png. Opcional.

CheckInInfo

Os metadados exigidos pelo parceiro para oferecer suporte a um método de check-in.

Representação JSON
{
  "checkInType": enum (CheckInType)
}
Campos
checkInType

enum (CheckInType)

Método usado para enviar instruções de check-in.

CheckInType

Vários métodos usados para enviar instruções de check-in.

Enums
CHECK_IN_TYPE_UNSPECIFIED Valor desconhecido.
EMAIL As informações de check-in serão enviadas por e-mail.
SMS As informações de check-in serão enviadas por SMS.

ItemOption

Representa complementos ou subitens.

Representação JSON
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Campos
id

string

Para opções que são itens, ID exclusivo do item.

name

string

Nome da opção.

prices[]

object (PriceAttribute)

Preço total da opção.

note

string

Observação relacionada à opção.

quantity

number

Para opções que são itens, quantidade.

productId

string

ID do produto ou da oferta associado a essa opção.

subOptions[]

object (ItemOption)

Para definir outras subopções aninhadas.

ProductDetails

Detalhes sobre o produto.

Representação JSON
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Campos
productId

string

ID do produto ou da oferta associada a este item de linha.

gtin

string

Número global do item comercial do produto. Útil se o offerId não estiver presente no Merchant Center. Opcional.

plu

string

Os códigos de consulta de preços, geralmente chamados de códigos PLU, números PLU, PLUs, códigos de produtos ou rótulos de produtos, são um sistema de números que identifica exclusivamente produtos a granel vendidos em supermercados e supermercados.

productType

string

Categoria do produto definida pelo comerciante. Por exemplo: "Início > Mercearia > Laticínios e Ovos > Leite > Leite integral"

productAttributes

map (key: string, value: string)

Detalhes do produto fornecidos pelo comerciante, por exemplo, { &quot;allergen&quot;: &quot;peanut&quot; }. Útil se o offerId não estiver presente no Merchant Center. Opcional.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ReservationItemExtension

Conteúdo do item de linha para pedidos de reserva, como restaurante, corte de cabelo etc. Próximo código: 15.

Representação JSON
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": number,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
Campos
status

enum (ReservationStatus)

Obrigatório: status da reserva.

userVisibleStatusLabel

string

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

type

enum (ReservationType)

Tipo de reserva. Pode não ser definido se nenhuma das opções de tipo for aplicável.

reservationTime

object (Time)

Horário em que o serviço/evento está programado para ocorrer. Pode ser um período, uma data ou uma data e hora exata.

userAcceptableTimeRange

object (Time)

Intervalo de tempo aceitável para o usuário.

confirmationCode

string

Código de confirmação para esta reserva.

partySize

number

O número de pessoas.

staffFacilitators[]

object (StaffFacilitator)

Os facilitadores da equipe que vão atender a reserva. Exemplo: A cabeleireira.

location

object (Location)

Local do serviço/evento.

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" }.

ReservationStatus

Status da reserva.

Enums
RESERVATION_STATUS_UNSPECIFIED Status não especificado.
PENDING A reserva está pendente.
CONFIRMED A reserva está confirmada.
CANCELLED A reserva foi cancelada pelo usuário.
FULFILLED A reserva foi concluída.
CHANGE_REQUESTED Alteração de reserva solicitada
REJECTED A reserva expirou ou foi rejeitada pelo integrador.

ReservationType

Tipo de reserva.

Enums
RESERVATION_TYPE_UNSPECIFIED Tipo não especificado.
RESTAURANT Reserva para o restaurante.
HAIRDRESSER Reserva de cabeleireiro.

StaffFacilitator

Informações sobre o funcionário do serviço.

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

string

O nome do facilitador de equipe. Exemplo: "João da Silva"

image

object (Image)

Imagens do artista.

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 pelo Actions on Google se a experiência de finalização de compra for gerenciada por essa plataforma.

paymentInfo

object (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 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 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

string

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 (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 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 (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
Campos
paymentType

enum (PaymentType)

O tipo de pagamento.

paymentMethodDisplayName

string

Nome da forma de pagamento visível para o usuário. Por exemplo, VISA **** 1234 Conta corrente **** 5678

paymentMethodVoiceName

string

Nome da forma de pagamento a ser falado para o usuário em dispositivos com assistentes somente de voz. Por exemplo, "visto terminado em um dois três quatro" ou "conta corrente com final 5 seis sete oito". Observação: esta é a string otimizada para voz a ser usada no lugar de paymentMethodDisplayName para dispositivos de assistente somente de voz. Se essa string não for definida, paymentMethodDisplayName será falado para o usuário.

PaymentType

PaymentType indica a forma de pagamento usada pelo comerciante. A ação também precisa fornecer um nome de exibição para a forma de pagamento.

Enums
PAYMENT_TYPE_UNSPECIFIED Tipo de pagamento não especificado.
PAYMENT_CARD Cartão de crédito/débito ou pré-pago.
BANK A forma de pagamento é uma conta bancária.
LOYALTY_PROGRAM A forma de pagamento é um programa de fidelidade.
CASH A forma de pagamento é dinheiro.
GIFT_CARD A forma de pagamento é um vale-presente.
WALLET Carteira de terceiros, como PayPal

PaymentMethodProvenance

Representa a procedência da forma de pagamento usada na transação.

Enums
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED A procedência não foi especificada.
PAYMENT_METHOD_PROVENANCE_GOOGLE Procedência é o Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT Procedência é Comerciante.

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 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 (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 para o usuário para o status. O comprimento máximo permitido é de 50 caracteres.

type

enum (PurchaseType)

Obrigatório: tipo de compra.

returnsInfo

object (PurchaseReturnsInfo)

Devolver informações 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 resultaram na rejeição do pedido.

PurchaseLocationType

Tipo de local da compra.

Enums
UNSPECIFIED_LOCATION Valor desconhecido.
ONLINE_PURCHASE Todas as compras compradas on-line.
INSTORE_PURCHASE Todas as compras na loja física.

PurchaseError

Erros que podem causar rejeição de ordens de compra.

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

enum (ErrorType)

Obrigatório: representa o motivo granular de um pedido ser recusado pelo comerciante.

description

string

Descrição adicional do erro.

entityId

string

ID da entidade correspondente ao erro. Exemplo que pode corresponder a OrderId / ItemOptionId.

updatedPrice

object (PriceAttribute)

Relevante no caso do tipo de erro PRICE_CHANGED / INCORRECT_PRICE.

availableQuantity

number

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

ErrorType

Tipos de erros possíveis.

Enums
ERROR_TYPE_UNSPECIFIED Erro desconhecido
NOT_FOUND Entidade não encontrada. Pode ser Item, FulfillmentOption ou Promoção. O ID da entidade é obrigatório.
INVALID Os dados da entidade não são válidos. pode ser Item, FulfillmentOption ou Promoção. O ID da entidade é obrigatório.
AVAILABILITY_CHANGED Item indisponível ou itens insuficientes para atender à solicitação. O ID da entidade é obrigatório.
PRICE_CHANGED O preço do item é diferente do preço na entidade "Item". O código da entidade e o preço atualizado são obrigatórios.
INCORRECT_PRICE Erros de preço em Tarifas, Total. O código da entidade e o preço atualizado são obrigatórios.
REQUIREMENTS_NOT_MET Restrições para aceitar o pedido não atendidas: tamanho mínimo do carrinho etc.
TOO_LATE FulfillmentOption expirou.
NO_CAPACITY Não há capacidade de serviço disponível.
INELIGIBLE O usuário não está qualificado para fazer pedidos (na lista de proibições).
OUT_OF_SERVICE_AREA Não é possível entregar no endereço solicitado devido a regras de fronteira etc.
CLOSED O restaurante está fechado para fazer o pedido.
PROMO_NOT_APPLICABLE Código de erro genérico para capturar todos os casos de falha na aplicação do código promocional, se nenhum dos itens abaixo for adequado. Adicione o código promocional como ID da entidade.
PROMO_NOT_RECOGNIZED O parceiro não reconheceu o código do cupom. Adicione o código promocional como ID da entidade.
PROMO_EXPIRED Não foi possível aplicar porque a promoção expirou. Adicione o código promocional como ID da entidade.
PROMO_USER_INELIGIBLE O usuário atual não está qualificado para este cupom. Adicione o código promocional como ID da entidade.
PROMO_ORDER_INELIGIBLE O pedido atual não está qualificado para este cupom. Adicione o código promocional como ID da entidade.
UNAVAILABLE_SLOT O horário de pedido antecipado não está disponível.
FAILED_PRECONDITION Restrições para aceitar o pedido não atendidas: tamanho mínimo do carrinho etc.
PAYMENT_DECLINED Pagamento inválido.
MERCHANT_UNREACHABLE Não foi possível entrar em contato com o comerciante. Isso é útil quando um parceiro é um agregador e não consegue alcançar o comerciante.

TicketOrderExtension

Itens para compra de ingressos, como filmes, esportes etc.

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

object (TicketEvent)

O evento aplicado a todos os ingressos de item 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 de ingresso, por exemplo, filme, show.

name

string

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

description

string

É a descrição do evento.

url

string

URL para as informações do evento.

location

object (Location)

O local onde o evento vai acontecer ou a localização de uma organização.

eventCharacters[]

object (EventCharacter)

Os caracteres relacionados a este evento. Pode ser diretores ou atores de um evento cinematográfico ou artistas de um show etc.

startDate

object (Time)

Horário de início.

endDate

object (Time)

Horário de término.

doorTime

object (Time)

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.

Tipo

O tipo do evento.

Enums
EVENT_TYPE_UNKNOWN Tipo de evento desconhecido.
MOVIE Filme.
CONCERT Show.
SPORTS Esportes.

EventCharacter

Um caractere de evento, por exemplo, organizador, artista etc.

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

enum (Type)

Tipo do caractere do evento, por exemplo, ator ou diretor.

name

string

Nome do personagem.

image

object (Image)

Imagens do personagem.

Tipo

Tipo de caractere.

Enums
TYPE_UNKNOWN Tipo desconhecido.
ACTOR Ator.
PERFORMER Artista
DIRECTOR Diretor
ORGANIZER Organizador.