Chiamate API dirette

In questo approccio all'interazione con l'API Merchant, effettua richieste non elaborate direttamente agli endpoint API, in genere tramite HTTP(S). Gestisci manualmente aspetti come la formazione del corpo della richiesta, l'impostazione delle intestazioni (inclusa l'autenticazione) e l'analisi della risposta.

Passaggio 1: Registrati come sviluppatore

Per utilizzare l'API Merchant, devi registrare i dati di contatto dello sviluppatore.

La registrazione esegue le seguenti operazioni:

• Crea un contatto tecnico per il tuo account Merchant Center assegnando il ruolo API developer a un utente. In questo modo, Google può inviare aggiornamenti importanti specifici per l'API e le funzionalità utilizzate dallo sviluppatore, ad esempio annunci di servizio e informazioni sulle nuove funzionalità, che potrebbero essere di interesse minore per i non sviluppatori.
• Consente di lavorare con più account commerciante senza dover eseguire la registrazione più volte. Quando ti registri, l'ID progetto Google Cloud utilizzato per l'autenticazione all'API Merchant è associato al tuo account Merchant Center, che ha i contatti tecnici (i API developer). In questo modo, puoi ricevere aggiornamenti importanti per tutti gli account commerciante che gestisci, a condizione che l'autenticazione venga eseguita con il progetto Google Cloud registrato.

Al momento della registrazione, rispetta i prerequisiti e le limitazioni descritti nella sezione Registrazione.

Per registrarti utilizzando il metodo developerRegistration.registerGcp, puoi iniziare con questo esempio, sostituendo {DEVELOPER_EMAIL} con l'indirizzo email appropriato nel corpo della richiesta.

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

Una chiamata riuscita restituisce una risorsa DeveloperRegistration, che conferma il collegamento tra il tuo progetto e il tuo account.

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

Passaggio 2: Gestire contatti e autorizzazioni dello sviluppatore

Al momento della registrazione:

• Se l'indirizzo email appartiene a un utente dell'account Merchant Center, a quest'ultimo viene concesso il ruolo API_DEVELOPER.
• Se l'indirizzo email non appartiene a un utente esistente, viene inviato un invito a quell'indirizzo. Il destinatario deve accettare l'invito per essere aggiunto come nuovo utente con il ruolo API_DEVELOPER.

Dopo la registrazione iniziale, ti consigliamo di aggiungere più sviluppatori e concedere loro diritti di accesso aggiuntivi.

Passaggio 2a. Concedere autorizzazioni aggiuntive

Il ruolo API_DEVELOPER è necessario per ricevere notifiche importanti, ma dispone di autorizzazioni minime in Merchant Center. Per consentire a questo utente di effettuare altre chiamate API o gestire le impostazioni nell'interfaccia utente di Merchant Center, devi concedergli ruoli aggiuntivi, come STANDARD o ADMIN. Per saperne di più, consulta Tipi di accesso.

Puoi aggiornare i diritti di accesso di un utente con il metodo accounts.users.patch.

L'esempio seguente mostra come aggiornare un utente per concedergli i ruoli ADMIN e API_DEVELOPER. In questo modo possono gestire completamente l'account e riceveranno anche comunicazioni relative all'API.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

Passaggio 2b. Aggiungere sviluppatori di backup

Per evitare interruzioni dell'accesso all'API se il contatto sviluppatore principale lascia la tua organizzazione, devi aggiungere almeno uno sviluppatore di backup.

Attenzione :se l'ultimo utente con il ruolo API_DEVELOPER viene rimosso dal tuo account Merchant Center, le chiamate API verranno bloccate dopo un periodo di tolleranza di 30 giorni. Durante questo periodo, gli amministratori account riceveranno avvisi via email.

Puoi aggiungere un utente con il metodo accounts.users.create o aggiornarne uno con accounts.users.patch. Ti consigliamo di assegnare a questo utente sia il ruolo ADMIN che quello API_DEVELOPER.

Passaggio 3: 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/v1/accounts/{ACCOUNT_ID}/dataSources

{
  "primaryProductDataSource": {
    "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.

Dopo aver eseguito correttamente questa richiesta, dovresti visualizzare la seguente risposta:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Copia il valore del campo name. Ti servirà per inserire un prodotto.

Puoi visualizzare questa origine dati nell'interfaccia utente di Merchant Center. Per ulteriori informazioni, vedi Come trovare la scheda Origini dati.

Passaggio 4: Inserisci un prodotto

Dopo aver creato l'origine dati, prova a inserirvi un prodotto. Esegui il seguente comando fornendo il ACCOUNT_ID corretto. Sostituisci {DATASOURCE_NAME} con il valore che hai copiato in precedenza.

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME}
{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "productAttributes": {
    "gender": "MALE",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

Dopo aver eseguito correttamente questa richiesta, dovresti visualizzare la seguente risposta:

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/en~US~tshirt-123",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "productAttributes": {
    "brand": "New brand",
    "gender": "MALE"
  }
}

L'ID prodotto del prodotto appena creato è 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. Vedi Visualizzare i dati di prodotto.