Inizia a utilizzare l'API Merchant

Per iniziare, abilita l'API Merchant nel tuo progetto Cloud.

Ecco come utilizzare l'API Merchant:

Utilizzo delle librerie client

L'API Merchant è composta da più API secondarie.

Ogni API secondaria dispone di esempi di codice e librerie client per aiutarti a iniziare.

Se utilizzi già l'API Content for Shopping, consulta la pagina dedicata alla compatibilità dell'API Content for Shopping.

Invio di richieste

L'API Merchant utilizza i nomi delle risorse anziché gli ID per identificarle. Un esempio di nome della risorsa per un prodotto può essereaccounts/123/products/online~en~US~sku123, dove 123 è l'identificatore univoco dell'account e online~en~US~sku123 è l'identificatore univoco del prodotto.

Per eseguire operazioni su una risorsa, invia richieste agli URL nel seguente formato:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}:{method}

Nota: la parte :{method} viene omessa per i metodi standard.

Ad esempio, questa richiesta eliminerà l'inventario regionale:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

Per creare una nuova risorsa, puoi utilizzare il nome della risorsa principale e il seguente URL

POST https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name of parent}/{resource}

Ad esempio, ecco come creare una nuova regione per account/123

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

Per maggiori dettagli su servizi specifici, consulta la documentazione di riferimento dell'API Merchant.

Utilizza gRPC o REST

L'API Merchant supporta gRPC e REST. Ecco i due modi per effettuare chiamate all'API Merchant:

gRPC (consigliato)	REST
Crea il corpo della richiesta come buffer di protocollo. Invia il corpo della richiesta al server con HTTP/2. Deserializza la risposta in un buffer del protocollo. Interpreta i risultati.	Crea il corpo della richiesta come oggetto JSON. Inviala al server utilizzando HTTP 1.1. Deserializza la risposta come oggetto JSON. Interpreta i risultati.

Nota: se utilizzi una libreria client, il meccanismo di trasporto predefinito è gRPC. Nella maggior parte dei casi, non devi fare altro che chiamare gli endpoint dell'API Merchant per utilizzare gRPC.

Ricevi assistenza

Per informazioni su come ricevere assistenza, consulta Ricevere assistenza per l'API Merchant.

Invia feedback

Il periodo beta ci offre l'opportunità di raccogliere e gestire i tuoi feedback prima del rilascio della disponibilità generale. Per fornire un feedback, invia uno dei seguenti elementi:

• Funzionalità dell'API: invia il modulo di feedback
• Documentazione:utilizza le valutazioni delle miniature in-page e il pulsante Invia feedback.
• Esempi e librerie:utilizza il pulsante Nuovo problema su GitHub.

Per fornire un feedback generale dopo l'implementazione di ogni attività, utilizza il modulo di feedback.