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 l'identificazione. 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 (opzione consigliata)	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. Invialo 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 rispondere al tuo feedback prima del rilascio della versione di 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.