Inizia

L'API Manufacturer Center (MfC) consente alle app di interagire direttamente con la piattaforma Manufacturer Center. Per aiutarti a iniziare, sono disponibili esempi di codice in Java e .NET.

Questa guida ti aiuterà a creare la tua prima applicazione utilizzando l'API Manufacturer Center. Prima di poter iniziare a programmare, ci sono alcune cose da fare.

Supporto REST

La nostra API REST supporta le operazioni CRUD di base per due diversi tipi di risorse:

Il resto della documentazione sarà scritto principalmente per Prodotto, ma la procedura dovrebbe essere simile per la ProductCertification.

Configurare l'account Manufacturer Center

  1. Crea un account Manufacturer Center.

  2. Assicurati di ricordare quale indirizzo email hai utilizzato per creare questo account Manufacturer Center, in quanto ti servirà in un secondo momento. Negli screenshot, sarà rappresentato come manufacturer_user@example.com.

Effettua la tua prima richiesta API (senza scrivere una riga di codice)

  1. Vai su Explorer API nella nostra documentazione per sviluppatori per Accounts.Products.list.

  2. Assicurati che l'Account Google a cui hai eseguito l'accesso sia elencato nell'impostazione "Utenti" nella scheda Impostazioni.

  3. In Explorer API, assicurati che nel menu a discesa Autenticazione sia selezionato Google OAuth 2.0:

  4. Inserisci accounts/{account_id}, sostituendo {account_id} con il tuo ID produttore del tuo account Manufacturer Center, nel campo "principale" del modulo e fai clic su Esegui.

  5. Dovresti visualizzare una risposta corretta. Complimenti! Hai effettuato la tua prima richiesta API di Manufacturer Center.

  6. Se in Manufacturer Center non hai ancora prodotti, non ne visualizzerai nessuno nell'elenco. A questo punto, puoi passare ad altre richieste e vedere cosa fanno. Poiché si tratta di un'API RESTful, tutte le richieste funzionano allo stesso modo. Una volta ottenuti i prodotti, un buon passaggio successivo è provare Accounts.Products.get.

Crea un progetto nella console API di Google

Le richieste all'API Manufacturer Center vengono effettuate tramite il progetto della console API. In questo caso supponiamo che accederai al tuo account Manufacturer Center, quindi ti consigliamo di utilizzare gli account di servizio per semplificare il flusso di autenticazione. Consulta la guida Account di servizio per i dettagli su come configurare un nuovo account di servizio da utilizzare con l'account Manufacturer Center.

La tua prima richiesta API autorizzata utilizzando Java

Ora che hai configurato un account di servizio e aggiunto l'ID account di servizio all'account Manufacturer Center, puoi accedere al tuo account utilizzando il codice Samples disponibile. Questa guida utilizza gli esempi Java per dimostrare l'utilizzo dell'API.

  1. Installa Apache Maven, se non l'hai ancora fatto.

  2. Scarica i nostri esempi di Shopping dalla pagina GitHub.

  3. Dalla sottodirectory java, crea gli esempi Java:

    $ mvn compile

  4. Ora esegui il codice ProductsListSample (l'esempio di ProductCertification è ListProductCertificationsSample):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  5. Se non hai seguito le istruzioni di configurazione nel file README che accompagna i file di origine, riceverai un messaggio di errore che indica che non è stata trovata nessuna configurazione di esempio. Segui le istruzioni nel file README per creare la directory di configurazione e popolarla con le informazioni appropriate. Il file JSON che hai scaricato durante la configurazione dell'account di servizio deve essere posizionato in questa directory con il nome file service-account.json. Ricordati di indicare al codice la posizione del file impostando la seguente variabile di ambiente.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. Ora che hai impostato la configurazione degli esempi, esegui di nuovo il codice ProductsListSample.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  7. A questo punto, il programma Java dovrebbe terminare l'esecuzione e stampare un elenco dei prodotti trovati o un messaggio che indica che non erano presenti prodotti nel tuo account. Se visualizzi un messaggio di errore simile a "L'utente non può accedere all'account 1234567890", è molto probabile che tu non abbia configurato l'utente con account di servizio come utente autorizzato in Manufacturer Center. Dal punto di vista dell'API, il progetto della console API ha inviato una richiesta per conto di un utente che non era nell'elenco degli amministratori di Manufacturer Center autorizzati, quindi ovviamente la richiesta avrebbe rifiutato.

  8. Puoi provare a eseguire ProductsListSample tutte le volte che vuoi, poiché si tratta di una richiesta di sola lettura. Puoi anche esplorare gli altri esempi creati per Java e .NET.