Chiamate API dirette

In questo approccio all'interazione con l'API Merchant, le richieste non elaborate vengono inviate direttamente agli endpoint API, in genere tramite HTTP(S). Devi gestire manualmente aspetti come la creazione 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 le informazioni di contatto dello sviluppatore.

La registrazione consente di:

  • Creare 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 specificamente sull'API e sulle funzionalità utilizzate dallo sviluppatore, ad esempio annunci di servizio e informazioni sulle nuove funzionalità, che potrebbero essere di minore interesse per i non sviluppatori.
  • 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 viene associato al tuo account Merchant Center, che ha i contatti tecnici (gli 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.

Durante la registrazione, rispetta i prerequisiti e le limitazioni descritti in Registrazione.

Per registrarti utilizzando il developerRegistration.registerGcp metodo, 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 progetto e l'account.

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

Passaggio 2: gestisci i contatti e le autorizzazioni degli sviluppatori

Quando ti registri:

  • Se l'indirizzo email appartiene a un utente dell'account Merchant Center, all'utente 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 ulteriori diritti di accesso.

Passaggio 2a: concedi autorizzazioni aggiuntive

Il ruolo API_DEVELOPER è necessario per ricevere notifiche importanti, ma ha 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, ad esempio STANDARD o ADMIN. Per saperne di più, consulta Tipi di accesso.

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

L'esempio seguente mostra come aggiornare un utente per concedergli i ruoli ADMIN e API_DEVELOPER. In questo modo, l'utente può gestire completamente l'account e riceverà 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: aggiungi 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.

Puoi aggiungere un utente con il accounts.users.create metodo o aggiornarne uno con accounts.users.patch. Ti consigliamo di assegnare a questo utente i ruoli ADMIN e API_DEVELOPER.

Passaggio 3: crea un'origine dati dei prodotti principale

Per inserire un prodotto, devi disporre di un'origine dati dei prodotti 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 saperne di più, consulta Come trovare la scheda Origini dati.

Passaggio 4: inserisci un prodotto

Dopo aver creato l'origine dati, prova a inserirvi un prodotto. Esegui il comando seguente, fornendo l'elemento 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 per il prodotto appena creato è en~US~tshirt-123. Puoi utilizzare il accounts.products.get metodo per recuperare i dettagli di questo prodotto. Puoi anche utilizzare l'interfaccia utente di Merchant Center per visualizzare questo prodotto. Per saperne di più sulla visualizzazione dei dati di prodotto, consulta Panoramica dei prodotti in Merchant Center.