L'API Transactions verrà ritirata il 3 maggio 2023, prima della disattivazione delle azioni di conversazione il 13 giugno 2023. Per ulteriori informazioni, vedi
Ritiro di Azioni di conversazione.
Method: orders.createWithCustomToken
Crea e restituisce il nuovo ordine utilizzando un token personalizzato creato da Google. Gli sviluppatori che utilizzano questo metodo devono impostare il token userToken passato da Google nella richiesta. Questo metodo viene utilizzato nei casi in cui gli sviluppatori o il commerciante salvano direttamente gli ordini su Google per conto dell'ordine (anziché Transazioni e flusso AMP).
Richiesta HTTP
POST https://actions.googleapis.com/v3/orders:createWithCustomToken
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
{
"header": {
object (OrderRequestHeader )
},
"order": {
object (Order )
},
"userToken": string
} |
Campi |
header |
object (OrderRequestHeader )
Obbligatorio: intestazione per la richiesta di creazione dell'ordine.
|
order |
object (Order )
Obbligatorio: ordine da creare. Nota: 1. I seguenti campi sono sempre obbligatori per creare un ordine valido: order.create_time, order.merchant_order_id, order.contents.line_items, order.contents.line_items.id 2. L'ordine deve avere almeno un elemento pubblicitario e l'elemento pubblicitario deve avere un verticale/un'estensione definito. 3. Tutte le estensioni (sia a livello di ordine che a livello di elemento pubblicitario) devono essere mappate a un tipo di verticale, ad esempio un ordine non è valido se rappresenta più di un verticale.
|
userToken |
string
Obbligatorio: token criptato fornito da Google al partner tramite un canale asincrono.
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Order
.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-09-12 UTC.
[null,null,["Ultimo aggiornamento 2024-09-12 UTC."],[[["This document explains the `orders:createWithCustomToken` method, which creates new Google Orders using a custom, Google-minted token."],["Developers should include the `userToken` provided by Google in the request."],["This process is typically used when developers or merchants directly save orders to Google on behalf of the order, rather than using Transactions or AMP flows."],["The request body must include a header, order details (with at least one line item and a specified vertical), and the `userToken`."],["A successful response will return the created `Order` object."]]],["This document outlines how to create a new order using a custom Google-minted token. It involves sending a `POST` request to `https://actions.googleapis.com/v3/orders:createWithCustomToken`. The request body requires a JSON structure with `header` (OrderRequestHeader object), `order` (Order object, including required fields like `create_time`, `merchant_order_id`, and line items), and a `userToken` (an encrypted token from Google). Successful requests return an `Order` object in the response body. The order must contain at least one line item, and all extensions should map to a single vertical type.\n"]]