Обновление порядка с 3p до AOG. Возвращает INVALID_ARGUMENT, если идентификатор заказа пуст или не равен идентификатору существующего заказа.
HTTP-запрос
PATCH https://actions.googleapis.com/v3/orders/{orderUpdate.order.merchantOrderId}
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
orderUpdate.order.merchantOrderId | Требуется: Продавец назначает внутренний идентификатор заказа. Этот идентификатор должен быть уникальным и требуется для последующих операций обновления заказа. Этот идентификатор может быть установлен равным предоставленному googleOrderId или любому другому уникальному значению. Обратите внимание, что идентификатор, представленный пользователям, — это userVisibleOrderId, который может быть другим, более удобным для пользователя значением. Максимально допустимая длина составляет 64 символа. |
Тело запроса
Тело запроса содержит данные со следующей структурой:
Представление JSON | |
---|---|
{ "header": { object ( |
Поля | ||
---|---|---|
header | Заголовок запроса на обновление заказа. | |
orderUpdate.type | Устарело: вместо этого используйте OrderUpdate.update_mask. Если type = SNAPSHOT, OrderUpdate.order должен быть всем заказом. Если type = ORDER_STATUS, это изменение статуса уровня заказа. Подбираются только order.last_update_time и этот вертикальный статус. Примечание: type.ORDER_STATUS поддерживает только обновления статуса PurcahaseOrderExtension, и мы не планируем расширять эту поддержку. Вместо этого мы рекомендуем использовать updateMask, так как он является более универсальным, расширяемым и может использоваться для всех вертикалей. | |
orderUpdate.order.googleOrderId | Идентификатор заказа, назначенный Google. | |
orderUpdate.order.userVisibleOrderId | Идентификатор пользователя, указывающий на текущий заказ. Этот идентификатор должен соответствовать идентификатору, отображаемому для этого заказа в других контекстах, включая веб-сайты, приложения и электронную почту. | |
orderUpdate.order.userVisibleStateLabel | Устарело: вместо этого используйте статус OrderExtensions. Видимая пользователем метка для состояния этого заказа. | |
orderUpdate.order.buyerInfo | Информация о покупателе. | |
orderUpdate.order.image | Изображение, связанное с заказом. | |
orderUpdate.order.createTime | Обязательно: Дата и время создания заказа. Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: | |
orderUpdate.order.lastUpdateTime | Дата и время последнего обновления заказа. Требуется для обновления заказа. Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: | |
orderUpdate.order.transactionMerchant | Продавец, который упростил оформление заказа. Это может отличаться от поставщика уровня позиции. Пример: заказ Expedia с позицией от ANA. | |
orderUpdate.order.contents | Требуется: содержимое заказа, представляющее собой группу позиций. | |
orderUpdate.order.priceAttributes[] | Цена, скидки, налоги и так далее. | |
orderUpdate.order.followUpActions[] | Последующие действия на уровне заказа. | |
orderUpdate.order.paymentData | Данные, связанные с оплатой заказа. | |
orderUpdate.order.termsOfServiceUrl | Ссылка на условия обслуживания, применимые к заказу/предлагаемому заказу. | |
orderUpdate.order.note | Примечания к заказу. | |
orderUpdate.order.promotions[] | Все рекламные акции, связанные с этим заказом. | |
orderUpdate.order.disclosures[] | Раскрытие информации, связанное с этим заказом. | |
orderUpdate.order.vertical | Устарело: вместо этого используйте вертикали. Эти свойства будут применяться ко всем позициям, если они не переопределены в какой-либо позиции. Эта вертикаль должна соответствовать типу вертикали уровня позиции. Возможные значения: Объект, содержащий поля произвольного типа. Дополнительное поле | |
orderUpdate.updateMask | Примечание. Существуют следующие соображения/рекомендации для следующих специальных полей: 1. order.last_update_time всегда будет обновляться как часть запроса на обновление. 2. order.create_time, order.google_order_id и order.merchant_order_id будут игнорироваться, если они предоставлены как часть updateMask. Разделенный запятыми список полных имен полей. Пример: | |
orderUpdate.userNotification | Если указано, отображает уведомление пользователю с указанным заголовком и текстом. Указание уведомления является предложением об уведомлении и не обязательно приведет к уведомлению. | |
orderUpdate.reason | Причина изменения/обновления. | |
Объединение полевых verticals . Эти свойства будут применяться ко всем позициям, если они не переопределены в какой-либо позиции. Эта вертикаль должна соответствовать типу вертикали уровня позиции. verticals могут быть только одним из следующих: | ||
orderUpdate.order.purchase | Заказ на покупку | |
orderUpdate.order.ticket | Заказ билетов |
Тело ответа
В случае успеха тело ответа содержит экземпляр Order
.
ЗаказатьОбновить
Обновление заказа.
Представление JSON | |
---|---|
{ "type": enum ( |
Поля | |
---|---|
type | Устарело: вместо этого используйте OrderUpdate.update_mask. Если type = SNAPSHOT, OrderUpdate.order должен быть всем заказом. Если type = ORDER_STATUS, это изменение статуса уровня заказа. Подбираются только order.last_update_time и этот вертикальный статус. Примечание: type.ORDER_STATUS поддерживает только обновления статуса PurcahaseOrderExtension, и мы не планируем расширять эту поддержку. Вместо этого мы рекомендуем использовать updateMask, так как он является более универсальным, расширяемым и может использоваться для всех вертикалей. |
order | |
updateMask | Примечание. Существуют следующие соображения/рекомендации для следующих специальных полей: 1. order.last_update_time всегда будет обновляться как часть запроса на обновление. 2. order.create_time, order.google_order_id и order.merchant_order_id будут игнорироваться, если они предоставлены как часть updateMask. Разделенный запятыми список полных имен полей. Пример: |
userNotification | Если указано, отображает уведомление пользователю с указанным заголовком и текстом. Указание уведомления является предложением об уведомлении и не обязательно приведет к уведомлению. |
reason | Причина изменения/обновления. |
Тип
Устарело: вместо этого используйте OrderUpdate.update_mask. Разрешены обновления заказа.
перечисления | |
---|---|
TYPE_UNSPECIFIED | Тип не указан, не следует задавать его явно. |
ORDER_STATUS | Только обновить статус заказа. |
SNAPSHOT | Обновить снимок заказа. |
Уведомление пользователя
Необязательное уведомление пользователя для отображения в рамках обновления заказа.
Представление JSON | |
---|---|
{ "title": string, "text": string } |
Поля | |
---|---|
title | Заголовок уведомления пользователя. Максимально допустимая длина составляет 30 символов. |
text | Содержание уведомления. Максимально допустимая длина составляет 100 символов. |