Questa pagina spiega come creare un account Merchant Center e caricare un prodotto di esempio utilizzando l'API Merchant.
Prima di iniziare
Abilita l'API Merchant nel tuo progetto Google Cloud.
Se l'integrazione API viene utilizzata in AppScript utilizzando il servizio di contenuti Shopping, viene creato un progetto Google Cloud predefinito e il servizio API Merchant viene abilitato automaticamente. Tuttavia, prima di utilizzare l'API Merchant, devi completare una registrazione una tantum come sviluppatore. Per ulteriori informazioni, consulta l'articolo Utilizzare il servizio API Merchant in Apps Script.
Crea un account
Per utilizzare l'API Merchant, devi avere un account Merchant Center. Per creare un account Merchant Center, consulta la sezione Guida introduttiva di Merchant Center.
Registrati come sviluppatore
Per utilizzare l'API Merchant, devi collegare il tuo account Merchant Center e il tuo progetto Google Cloud utilizzando il metodo di registrazione sviluppatore, come segue:
Collega Merchant Center e il tuo progetto Google Cloud: il collegamento viene approvato automaticamente, poiché il chiamante dispone di un token di accesso o di una chiave API validi del progetto Google Cloud ed è un utente autorizzato dell'account Merchant Center.
Aggiungi un utente sviluppatore API all'account Merchant Center: l'API di registrazione aggiunge un utente sviluppatore API all'account Merchant Center. Se un utente esiste già, gli verrà concesso il nuovo tipo di accesso. In caso di un nuovo utente, riceverà un invito via email a Merchant Center.
Ti consigliamo di utilizzare il metodo accounts.users.create
per aggiungere sviluppatori API aggiuntivi o di backup per verificare che, nel caso in cui
la persona lasci la tua organizzazione o venga eliminata, tu possa comunque disporre di una registrazione
dello sviluppatore valida.
Dopo la registrazione, puoi visualizzare lo stato della registrazione utilizzando
GetDeveloperRegistration o annullare la registrazione utilizzando UnregisterGCP.
La chiamata di registrazione è
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
{
developer_email:"example-email@example.com"
}
Dopo l'esecuzione corretta della richiesta, prevedi la risposta:
{
"developerRegistration": {
"name": "accounts/ACCOUNT_ID/developerRegistration",
"gcpIds": ["GOOGLE_CLOUD_PROJECT_ID"]
}
}
Una volta registrato lo sviluppatore dell'API, puoi utilizzare il metodo
accounts.users.patch
per concedergli ruoli aggiuntivi, come STANDARD e ADMIN.
Recuperare l'ID account
Puoi ottenere l'ID account utilizzando il metodo accounts.list.
Puoi utilizzare Explorer API di Google per eseguire richieste API Merchant. Explorer API utilizza Google OAuth 2.0 per l'autenticazione. Prima di eseguire le richieste, assicurati che la casella di controllo Google OAuth 2.0 sia selezionata.
Per autenticarti utilizzando OAuth 2.0, devi accedere al tuo Account Google e poi ad Explorer API. Devi anche consentire a Explorer API di gestire le tue schede e i tuoi account prodotto.
La seguente richiesta mostra come recuperare l'ID account:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
o
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}
Una volta eseguita correttamente la richiesta, viene visualizzata la seguente risposta:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
Copia {ACCOUNT_ID} perché ti servirà per eseguire altre richieste.
Creare un'origine dati dei prodotti principale
Per inserire un prodotto, devi disporre di un'origine dei dati di prodotto principale. La seguente richiesta mostra come creare un'origine dati che puoi utilizzare per inserire un prodotto nel tuo account:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1
{
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"contentLanguage": "en",
"countries": [
"US"
],
"feedLabel": "US"
},
"name": "primary-data-source",
"displayName": "Primary Products Data Source"
}
Sostituisci {ACCOUNT_ID} con l'ID dell'account Merchant Center che hai creato.
Una volta eseguita correttamente questa richiesta, viene visualizzata la seguente risposta:
{
"name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
"dataSourceId": "{DATASOURCE_ID}",
"displayName": "Primary Products Data Source",
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"feedLabel": "US",
"contentLanguage": "en",
"countries": [
"US"
],
"defaultRule": {
"takeFromDataSources": [
{
"self": true
}
]
}
},
"input": "API"
}
Copia il valore del campo name perché ti servirà per inserire un
prodotto.
La creazione dell'origine dati richiede alcuni minuti prima che sia disponibile per l'inserimento dei prodotti.
Puoi visualizzare questa origine dati nell'interfaccia utente di Merchant Center. Per ulteriori informazioni, vedi Come trovare la scheda Origini dati.
Inserisci un prodotto
Per inserire un prodotto di esempio nel tuo account, esegui la seguente richiesta:
POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1
{
"channel": "ONLINE",
"contentLanguage": "en",
"feedLabel": "US",
"name": "Red T-shirt",
"attributes": {
"gender": "Male",
"brand": "New brand"
},
"offerId": "tshirt-123"
}
Sostituisci {DATASOURCE_NAME} con il valore che hai copiato in precedenza.
Una volta eseguita correttamente questa richiesta, viene visualizzata la seguente risposta:
{
"name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
"product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
"channel": "ONLINE",
"offerId": "tshirt-123",
"contentLanguage": "en",
"feedLabel": "US",
"attributes": {
"brand": "New brand",
"gender": "Male"
}
}
L'ID prodotto del prodotto appena creato è online~en~US~tshirt-123. Puoi
utilizzare il metodo accounts.products.get
per recuperare i dettagli di questo prodotto. Puoi anche utilizzare l'interfaccia utente di Merchant Center per visualizzare questo prodotto.