Puoi utilizzare questa guida per integrare l'API Merchant con l'implementazione esistente dell'API Content for Shopping.
Inizia
Consulta la progettazione dell'API Merchant per i dettagli sul l'API Merchant e le relative API secondarie.
Per iniziare a utilizzare l'API Merchant, modifica gli URL delle richieste nel seguente modo formato:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
Consulta la guida rapida e consulta il riferimento dell'API Merchant Center per ulteriori informazioni.
Supporto gRPC
L'API Merchant supporta gRPC e REST. Puoi utilizzare gRPC per l'API Merchant e REST per l'API Content for Shopping contemporaneamente nel tempo.
Le librerie client dell'API Merchant richiedono e gRPC.
Per ulteriori informazioni, consulta Utilizzare gRPC informazioni.
Compatibilità
Questa guida descrive le modifiche generali che si applicano all'intera API Merchant. Consulta le seguenti guide per le modifiche a funzionalità specifiche:
- Eseguire la migrazione della gestione degli account
- Eseguire la migrazione delle impostazioni di spedizione
- Eseguire la migrazione della gestione dei prodotti
- Eseguire la migrazione della gestione delle origini dati
- Eseguire la migrazione della gestione degli inventari
- Eseguire la migrazione della gestione delle promozioni
- Eseguire la migrazione della gestione dei report
- Eseguire la migrazione della gestione delle origini conversione
- Eseguire la migrazione della gestione delle partnership per i feed locali
L'API Merchant è progettata per funzionare insieme all'API Content for Shopping esistente le funzionalità della versione 2.1.
Ad esempio, puoi utilizzare l'API Merchant Inventories insieme alle
Inventari e inventari dell'API Content for Shopping v2.1
Implementazione di products. Tu
potrebbe utilizzare l'API Content for Shopping per caricare un nuovo
prodotto (che vendi
in un negozio locale), poi utilizza l'API Merchant Inventories
LocalInventory:
per gestire le informazioni in negozio per quel prodotto.
Richieste batch
L'API Merchant non supporta il metodo customBatch descritto in
API Content for Shopping. Consulta l'articolo sull'invio di batch
richieste. Se usi customBatch e
per l'API Merchant Center, spiegaci perché nel tuo
feedback.
Identificatori
Per allinearci ai principi di miglioramento delle API di Google, abbiamo hanno apportato alcune modifiche agli identificatori per le risorse dell'API Merchant.
il nome sostituisce l'ID
Tutte le risorse dell'API Merchant utilizzano il campo name come identificatore univoco.
Ecco un esempio di come utilizzare il campo name nelle chiamate:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
Questo nuovo campo name viene restituito come identificatore della risorsa per tutte le risorse di lettura
di scrivere chiamate nell'API Merchant.
Il valore restituito nei campi name utilizza il nuovo formato ID.
Ad esempio, implementa un metodo getName() per recuperare name da un
e archiviare l'output come variabile anziché creare la risorsa name
dagli ID commerciante e risorsa.
Nuovo formato ID
Nell'API Merchant, gli ID risorsa utilizzano il seguente formato:
channel~language~feedLabel~offerId
Le risorse dell'API Content hanno utilizzato : anziché ~ tra ogni valore nell'ID:
channel:language:feedLabel:offerId
Tutte le chiamate API Merchant restituiscono il nuovo formato con ~ tra i valori della variabile
ID. Ti consigliamo di archiviare il nuovo formato della risposta e di utilizzarlo nel tuo
chiamate future.
campi padre per le risorse figlio
Nell'API Merchant, tutte le risorse secondarie hanno il campo parent. Puoi utilizzare
il campo parent per specificare il name della risorsa in cui inserire l'elemento figlio,
anziché passare l'intera risorsa padre. Puoi anche usare parent
campo con list metodi per elencare le risorse figlio di quel parent.
Ad esempio, per elencare gli inventari locali per un determinato prodotto, specifica la
name del prodotto
parent
per
list
. In questo caso, il valore product specificato è il parent del
LocalInventory:
di risorse restituite.
Tipi
Di seguito sono riportati alcuni tipi comuni condivisi nelle API secondarie dell'API Merchant.
Prezzo
Ecco cosa è cambiato per Price nel pacchetto Merchant Common:
| API Content | API Merchant | |
|---|---|---|
| Campo dell'importo | value:string |
amountMicros:int64 |
| Campo Valuta | currency:string
|
currencyCode:string |
L'importo di Price viene ora registrato in micro, dove 1 milione di micro è
equivalente all'unità standard della tua valuta.
Nell'API Content for Shopping, Price era un numero decimale sotto forma di
stringa.
Il nome del campo dell'importo è cambiato da value a amountMicros
Il nome del campo valuta è stato modificato da currency a currencyCode. La
rimangono nel formato ISO 4217.