Librerie client di AutoML Vision Object Detection

Questa pagina mostra come iniziare a utilizzare le librerie client di Cloud per l'API AutoML AutoML. Per ulteriori informazioni sulle librerie client per le API Cloud, incluse quelle meno recenti dei client API di Google, consulta la spiegazione delle librerie client.

Installazione della libreria client

C#

Per ulteriori informazioni, consulta Configurazione di un ambiente di sviluppo C# .

install-package Google.Cloud.AutoML.V1 -pre

Go

Per ulteriori informazioni, consulta Configurazione di un ambiente di sviluppo Go.

go get cloud.google.com/go/automl

Java

Per ulteriori informazioni, consulta Configurazione di un ambiente di sviluppo Java.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.37.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-automl</artifactId>
  </dependency>

If you are using Gradle, add the following to your dependencies:

implementation 'com.google.cloud:google-cloud-automl:2.41.0'

If you are using sbt, add the following to your dependencies:

libraryDependencies += "com.google.cloud" % "google-cloud-automl" % "2.41.0"

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Node.js

Per ulteriori informazioni, vedi Configurazione di un ambiente di sviluppo Node.js.

npm install --save @google-cloud/automl

PHP

Per ulteriori informazioni, vedi Utilizzo di PHP su Google Cloud.

composer require google/cloud-automl

Python

Per ulteriori informazioni, consulta Configurazione di un ambiente di sviluppo Python.

pip install --upgrade google-cloud-automl

Ruby

Per ulteriori informazioni, consulta Configurazione di un ambiente di sviluppo Ruby.

gem install google-cloud-automl

Configurazione dell'autenticazione

Per eseguire la libreria client devi prima configurare l'autenticazione. Un modo per farlo è creare un account di servizio e impostare una variabile d'ambiente, come illustrato nei passaggi seguenti. Per altri metodi di autenticazione, consulta la pagina Autenticazione come account di servizio.

Console

Crea un account di servizio:

1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

   Vai a Crea account di servizio
2. Seleziona il progetto.

3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.

   Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

4. Fai clic su Crea e continua.

5. Concedi il ruolo Project > Owner all'account di servizio.

   Per concedere il ruolo, trova l'elenco Seleziona un ruolo e scegli Project > Owner.

   Nota: il campo Ruolo influisce sulle risorse a cui l'account di servizio può accedere nel progetto. Puoi revocare questi ruoli o concedere ruoli aggiuntivi in un secondo momento. In ambienti di produzione, non concedere i ruoli Proprietario, Editor o Visualizzatore. Concedi invece un ruolo predefinito o un ruolo personalizzato che soddisfi le tue esigenze.
6. Fai clic su Continua.

7. Fai clic su Fine per completare la creazione dell'account di servizio.

   Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.

Crea una chiave dell'account di servizio:

1. Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
2. Fai clic su Chiavi.
3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
4. Fai clic su Crea. Un file della chiave JSON viene scaricato sul computer.
5. Fai clic su Chiudi.

gcloud

Configura l'autenticazione:

1. Crea l'account di servizio:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

   Sostituisci SERVICE_ACCOUNT_NAME con un nome per l'account di servizio.

2. Concedi il ruolo IAM roles/owner all'account di servizio:

   gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/owner

   Sostituisci quanto segue:

   • SERVICE_ACCOUNT_NAME: il nome dell'account di servizio.
   • PROJECT_ID: l'ID progetto in cui hai creato l'account di servizio
   Nota: il flag --role influisce sulle risorse a cui l'account di servizio può accedere nel progetto. Puoi revocare questi ruoli o concedere ruoli aggiuntivi in un secondo momento. In ambienti di produzione, non concedere i ruoli Proprietario, Editor o Visualizzatore. Concedi invece un ruolo predefinito o un ruolo personalizzato che soddisfi le tue esigenze.

3. Genera il file della chiave:

   gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

   Sostituisci quanto segue:

   • FILE_NAME: un nome per il file della chiave
   • SERVICE_ACCOUNT_NAME: il nome dell'account di servizio.
   • PROJECT_ID: l'ID progetto in cui hai creato l'account di servizio

Fornisci le credenziali di autenticazione al codice dell'applicazione impostando la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS. Questa variabile si applica solo alla sessione di shell attuale. Se vuoi che la variabile venga applicata a future sessioni shell, impostala nel file di avvio della shell, ad esempio nel file ~/.bashrc o ~/.profile.

Linux o macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

Ad esempio:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

Per PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

Ad esempio:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

Per il prompt dei comandi:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

Utilizzo della libreria client

Il seguente esempio mostra come utilizzare la libreria client.

C#

Per informazioni su come utilizzare le librerie client con AutoML Object Detection, consulta le seguenti guide:

• Gestione dei set di dati
• Gestione dei modelli
• Valutazione dei modelli
• Annotazione di un'immagine
• Annotazione immagine batch

Go

Per informazioni su come utilizzare le librerie client con AutoML Object Detection, consulta le seguenti guide:

• Gestione dei set di dati
• Gestione dei modelli
• Valutazione dei modelli
• Annotazione di un'immagine
• Annotazione immagine batch

Java

Per informazioni su come utilizzare le librerie client con AutoML Object Detection, consulta le seguenti guide:

• Gestione dei set di dati
• Gestione dei modelli
• Valutazione dei modelli
• Annotazione di un'immagine
• Annotazione immagine batch

Node.js

Per informazioni su come utilizzare le librerie client con AutoML Object Detection, consulta le seguenti guide:

• Gestione dei set di dati
• Gestione dei modelli
• Valutazione dei modelli
• Annotazione di un'immagine
• Annotazione immagine batch

PHP

Per informazioni su come utilizzare le librerie client con AutoML Object Detection, consulta le seguenti guide:

• Gestione dei set di dati
• Gestione dei modelli
• Valutazione dei modelli
• Annotazione di un'immagine
• Annotazione immagine batch

Python

Per informazioni su come utilizzare le librerie client con AutoML Object Detection, consulta le seguenti guide:

• Gestione dei set di dati
• Gestione dei modelli
• Valutazione dei modelli
• Annotazione di un'immagine
• Annotazione immagine batch

Ruby

Per informazioni su come utilizzare le librerie client con AutoML Object Detection, consulta le seguenti guide:

• Gestione dei set di dati
• Gestione dei modelli
• Valutazione dei modelli
• Annotazione di un'immagine
• Annotazione immagine batch

Risorse aggiuntive

C#

• Documentazione di riferimento per le API
• Codice sorgente
• Issue Tracker di GitHub
• Stack Overflow

Go

• Documentazione di riferimento per le API
• Codice sorgente
• Issue Tracker di GitHub
• Stack Overflow

Java

• Documentazione di riferimento per le API
• Codice sorgente
• Issue Tracker di GitHub
• Stack Overflow

Node.js

• Documentazione di riferimento per le API
• Codice sorgente
• Issue Tracker di GitHub
• Stack Overflow

PHP

• Documentazione di riferimento per le API
• Codice sorgente
• Issue Tracker di GitHub
• Stack Overflow

Python

• Documentazione di riferimento per le API
• Codice sorgente
• Issue Tracker di GitHub
• Stack Overflow

Ruby

• Documentazione di riferimento per le API
• Codice sorgente
• Issue Tracker di GitHub
• Stack Overflow