Per iniziare

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

Questa guida ti aiuterà a creare la tua prima applicazione utilizzando l'API Manufacturer Center. Prima di iniziare a programmare, devi eseguire alcune operazioni.

Assistenza REST

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

La parte restante di questa documentazione sarà scritta principalmente per Product, ma la procedura dovrebbe essere simile per ProductCertification.

Configura l'account Manufacturer Center

  1. Crea un account Manufacturer Center.

  2. Assicurati di ricordare l'indirizzo email utilizzato per creare questo account Manufacturer Center, in quanto ti servirà in un secondo momento. Negli screenshot è indicata come manufacturer_user@example.com.

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

  1. Vai allo strumento Explorer API nella nostra documentazione per gli sviluppatori relativa a Accounts.Products.list.

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

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

  4. Inserisci accounts/{account_id}, sostituendo {account_id} con l'ID produttore dell'account Manufacturer Center, nel campo "genitore" del modulo, quindi fai clic su Esegui.

  5. Dovresti vedere una risposta corretta. Complimenti. Hai presentato la tua prima richiesta API di Manufacturer Center.

  6. Se non hai ancora prodotti in Manufacturer Center, non ne troverai l'elenco. A questo punto, puoi passare ad altre richieste e dare un'occhiata a cosa fanno. Poiché si tratta di un'API RESTful, tutte le richieste funzionano in modo simile. Un buon passo successivo, una volta che hai i prodotti, è 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. Qui supponiamo che tu accederà al tuo account Manufacturer Center, quindi ti consigliamo di utilizzare gli account di servizio per semplificare il flusso di autenticazione. Per informazioni dettagliate su come configurare un nuovo account di servizio da utilizzare con l'account Manufacturer Center, consulta la guida relativa agli account di servizio.

La tua prima richiesta API autorizzata a utilizzare Java

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

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

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

  3. All'interno della sottodirectory java, crea gli esempi Java:

    $ mvn compile
    
  4. Ora esegui il codice ProductsListSample (l'esempio per ProductCertification è ListProductCertificationsSample):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  5. Se non hai seguito le indicazioni per la configurazione nel file README associato ai file di origine, riceverai un messaggio di errore che indica che non è stato possibile trovare una configurazione di esempio. Segui le istruzioni nel file README per creare la directory di configurazione e completarla con le informazioni appropriate. Il file JSON scaricato durante la configurazione dell'account di servizio deve essere posizionato in tale directory con il nome file service-account.json. Ricordati di comunicare al codice la posizione del tuo file impostando la seguente variabile di ambiente.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
    
  6. Ora che hai impostato la configurazione di esempio, 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 e stampare un elenco di prodotti trovati o un messaggio che indica che non sono presenti prodotti nell'account. Se ricevi un errore simile a "L'utente non può accedere all'account 1234567890", è molto probabile che tu non abbia configurato l'utente dell'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, naturalmente, rifiuterebbe tale richiesta.

  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 che abbiamo creato sia per Java che per .NET.