Method: orders.patch

A ordem foi atualizada de 3p para AOG. Retorna INVALID_MCC se o ID do pedido estiver vazio ou não for igual a um pedido existente.

Solicitação HTTP

PATCH https://actions.googleapis.com/v3/orders/{orderUpdate.order.merchantOrderId}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
orderUpdate.order.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 64 caracteres.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "header": {
    object (OrderRequestHeader)
  },
  "orderUpdate": {
    "type": enum (Type),
    "order": {
      "googleOrderId": 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.
    },
    "updateMask": string,
    "userNotification": {
      object (UserNotification)
    },
    "reason": string
  }
}
Campos
header

object (OrderRequestHeader)

Cabeçalho da solicitação de atualização do pedido.

orderUpdate.type
(deprecated)

enum (Type)

Obsoleto: use OrderUpdate.update_mask. Se tipo = SNAPSHOT, OrderUpdate.order deverá ser o pedido inteiro. Se type = ORDER_STATUS, essa é a mudança de status no nível do pedido. Somente order.last_update_time e este status de indústria são coletados. Observação: type.ORDER_STATUS só é compatível com atualizações de status PurcahaseOrderExtension, e não há planos de ampliar esse suporte. Em vez disso, recomendamos o uso de updateMask, que é mais genérico, extensível e pode ser usado para todos os setores.

orderUpdate.order.googleOrderId

string

ID do pedido atribuído pelo Google.

orderUpdate.order.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.

orderUpdate.order.userVisibleStateLabel
(deprecated)

string

Obsoleto: use o status "OrderExtensions". Marcador visível ao usuário para o estado deste pedido.

orderUpdate.order.buyerInfo

object (UserInfo)

Informações sobre o comprador.

orderUpdate.order.image

object (Image)

Imagem associada ao pedido.

orderUpdate.order.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".

orderUpdate.order.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".

orderUpdate.order.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.

orderUpdate.order.contents

object (Contents)

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

orderUpdate.order.priceAttributes[]

object (PriceAttribute)

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

orderUpdate.order.followUpActions[]

object (Action)

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

orderUpdate.order.paymentData

object (PaymentData)

Dados relacionados ao pagamento do pedido.

orderUpdate.order.termsOfServiceUrl

string

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

orderUpdate.order.note

string

Observações anexadas a um pedido.

orderUpdate.order.promotions[]

object (Promotion)

Todas as promoções associadas a este pedido.

orderUpdate.order.disclosures[]

object (Disclosure)

Declarações associadas a este pedido.

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

orderUpdate.updateMask

string (FieldMask format)

Observação: existem as seguintes considerações/recomendações para os seguintes campos especiais: 1. order.last_update_time sempre será atualizado como parte da solicitação de atualização. 2. order.create_time, order.google_order_id e order.merchant_order_id serão ignorados se fornecidos como parte da updateMask.

Uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".

orderUpdate.userNotification

object (UserNotification)

Se especificado, exibe uma notificação para o usuário com o título e o texto especificados. Especificar uma notificação é uma sugestão para notificar, mas não garante que ela seja enviada.

orderUpdate.reason

string

Motivo da mudança/atualização.

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:
orderUpdate.order.purchase

object (PurchaseOrderExtension)

Ordem de compra

orderUpdate.order.ticket

object (TicketOrderExtension)

Pedido de passagem

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Order.

OrderUpdate

Atualizar um pedido.

Representação JSON
{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}
Campos
type
(deprecated)

enum (Type)

Obsoleto: use OrderUpdate.update_mask. Se tipo = SNAPSHOT, OrderUpdate.order deverá ser o pedido inteiro. Se type = ORDER_STATUS, esta é a alteração de status no nível do pedido. Somente order.last_update_time e este status de indústria são coletados. Observação: type.ORDER_STATUS só é compatível com atualizações de status PurcahaseOrderExtension, e não há planos de ampliar esse suporte. Em vez disso, recomendamos o uso de updateMask, que é mais genérico, extensível e pode ser usado para todos os setores.

order

object (Order)

updateMask

string (FieldMask format)

Observação: existem as seguintes considerações/recomendações para os seguintes campos especiais: 1. order.last_update_time sempre será atualizado como parte da solicitação de atualização. 2. order.create_time, order.google_order_id e order.merchant_order_id serão ignorados se fornecidos como parte da updateMask.

Uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".

userNotification

object (UserNotification)

Se especificado, exibe uma notificação para o usuário com o título e o texto especificados. Especificar uma notificação é uma sugestão e não há garantia de que ela resultará em uma.

reason

string

Motivo da alteração/atualização.

Tipo

Obsoleto: use OrderUpdate.update_mask. Atualizações permitidas para um pedido.

Enums
TYPE_UNSPECIFIED Tipo não especificado, não deve definir isso explicitamente.
ORDER_STATUS Atualize apenas o status do pedido.
SNAPSHOT Atualizar o resumo do pedido.

UserNotification

Notificação opcional para o usuário a ser exibida como parte da atualização do pedido.

Representação JSON
{
  "title": string,
  "text": string
}
Campos
title

string

O título da notificação do usuário. O comprimento máximo permitido é de 30 caracteres.

text

string

O conteúdo da notificação. O comprimento máximo permitido é de 100 caracteres.