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.
Crea un account
Per utilizzare l'API Merchant, devi disporre di un account Merchant Center. Per creare un account Merchant Center, consulta la sezione Guida introduttiva a Merchant Center.
Recuperare l'ID account
Puoi ottenere l'ID account utilizzando il metodo
accounts.list.
Puoi utilizzare Explorer API di Google per eseguire richieste dell'API Merchant. Explorer API utilizza OAuth 2.0 di Google 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 di prodotto e i tuoi account.
La seguente richiesta mostra come recuperare l'ID account:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
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.
Crea un'origine dati principale dei prodotti
Per inserire un prodotto, devi avere un'origine dati di prodotto principale. La seguente richiesta mostra come creare un'origine dati da 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.
Sono necessari alcuni minuti prima che l'origine dati creata sia disponibile per l'inserimento di prodotti.
Puoi visualizzare questa origine dati nell'interfaccia utente di Merchant Center. Per ulteriori informazioni, consulta 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.
Dopo l'esecuzione corretta della 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 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.