API Partner per i feed locali

Il programma di partnership per i feed locali consente ai rivenditori di usufruire degli annunci di inventario locale e delle schede di prodotto locali senza costi senza dover creare i propri feed principali e di inventario locale dei prodotti. I rivenditori possono fornire le proprie informazioni su vendite e inventari a un fornitore di dati di inventario affidabile che può condividerle con Google. Per l'elenco dei partner di dati supportati, consulta Informazioni sul programma di partnership per i feed locali.

Puoi aggiungere l'inventario locale dei prodotti caricando un feed di inventario locale dei prodotti.

Per fare in modo che il tuo fornitore di dati di inventario venga aggiunto a Merchant Center, fornisci i dettagli in Feedback per i fornitori di dati dei point of sale per mostrare i prodotti locali su Google.

Per informazioni sulla migrazione dall'API Content for Shopping, consulta Eseguire la migrazione della partnership per i feed locali.

Recuperare lo stato dell'onboarding di un rivenditore

Puoi utilizzare il metodo lfpMerchantStates.get per recuperare lo stato delle proprietà a livello di commerciante relative all'integrazione della partnership con i feed locali. In base alle proprietà fornite, puoi verificare se l'integrazione funziona come previsto o se è necessaria un'azione aggiuntiva.

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpMerchantStates/{TARGET_MERCHANT_ID}

Inserire un inventario

Per inserire un inventario, utilizza la seguente richiesta:

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert

{
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "{OFFER_ID}",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "regionCode": "US",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Sostituisci quanto segue:

  • {PARENT}: il formato è accounts/{ACCOUNT_ID}, dove {ACCOUNT_ID} è l'identificatore univoco dell'account Merchant Center.
  • {OFFER_ID}: l'identificatore univoco del prodotto.
  • {STORE_CODE}: l'identificatore del negozio del commerciante.
  • {TARGETMERCHANT_ID}: l'ID account della attività per cui vuoi inviare l'inventario.

Dovresti vedere la seguente risposta:

{
 "name": "accounts/{merchantId}/lfpInventories/{TARGETMERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "{OFFER_ID}",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "feedLabel": "US"
}

Per ulteriori informazioni, consulta Metodo: accounts.lfpInventories.insert.

Inserire una promozione

Per inserire una vendita, utilizza la seguente richiesta:

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert

{
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "offerId",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": 2,
 "regionCode": "US",
 "saleTime": "2024-01-08T08:00:00Z",
 "storeCode": "123",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Sostituisci quanto segue:

  • {TARGETMERCHANT_ID}: l'ID account dell'attività per cui inviare la vendita.

Dovresti vedere la seguente risposta:

{
 "name": "accounts/1000005718521947/lfpSales/{UUID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "offerId",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": "2",
 "saleTime": "2024-01-08T08:00:00Z",
 "uid": "{UUID}",
 "feedLabel": "US"
}

Per ulteriori informazioni, consulta Metodo: accounts.lfpSales.insert

Inserire un negozio

Per inserire un negozio, utilizza la seguente richiesta:

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Sostituisci quanto segue:

  • {STORE_CODE}: un identificatore univoco del magazzino.
  • {TARGETMERCHANT_ID}: l'ID account dell'attività per cui inviare il negozio.

Dovresti vedere la seguente risposta:

{
 "name": "accounts/{MERCHANT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "1000005718454644",
 "storeCode": "{STORE_CODE}",
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "matchingState": "STORE_MATCHING_STATE_MATCHED"
}

Per ulteriori informazioni, consulta Metodo: accounts.lfpStores.insert.

Inviare una notifica a un rivenditore

Puoi utilizzare il metodo SendLfpNotification per inviare una notifica a un rivenditore. Ad esempio, puoi utilizzare questo metodo per inviare una notifica di onboarding al rivenditore.

POST https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpNotifications:send

{
  "target_account": {TARGETMERCHANT_ID},
  "email_address": {EMAIL_ADDRESS},
  "type": {TYPE}
}

Sostituisci quanto segue:

  • {ACCOUNT_ID}: l'identificatore univoco del tuo account Merchant Center.
  • {TARGETMERCHANT_ID}: l'identificatore univoco dell'account a cui vuoi inviare la notifica.
  • {EMAIL_ADDRESS}: l'indirizzo email dell'account a cui vuoi inviare la notifica.
  • {TYPE}: in questo campo puoi passare solo il valore di stringa ONBOARDING_UI.