Guida all'integrazione

Ottieni chiave privata

Utilizzo dell'interfaccia di onboarding

Per l'integrazione con l'API, devi creare un progetto Google Cloud. Dopodiché, crea un account di servizio e ottieni una chiave privata. Per iniziare, fai clic sul seguente pulsante:

Crea un account di servizio

Generazione manuale chiave

Se l'interfaccia sopra indicata non funziona, prova a procedere nel seguente modo:

  1. Vai a Google Cloud Console.
  2. Scegli il progetto con cui si accede all'API.
  3. Nel menu IAM e a sinistra di IAM, individua gli account di servizio e crea un nuovo account di servizio che sarà il proprietario del progetto.
  4. Dopo aver creato l'account di servizio, dovresti ricevere una chiave privata.

Autorizza account di servizio

Una volta creato un account di servizio:

  1. Contatta il team di GTAF all'indirizzo mdp-support@google.com con un Account Google che è il proprietario del progetto. L'account Google verrà autorizzato per accedere agli endpoint dell'API Mobile Data Plan Sharing.
  2. Associa account di servizio all'operatore sul Portale ISP di Google. L'operatore può creare questa associazione andando ad Accesso API.

Attiva la raccolta

Una volta completata l'autorizzazione:

  1. Visita Google Cloud Console.
  2. Assicurati di aver selezionato il progetto corretto nel menu a discesa della barra dei menu in alto.
  3. Attiva l'API Mobile Data Plan Sharing nella libreria API.
  4. Attiva l'API Predata di condivisione del piano dati mobili nella libreria API.

Test accesso API

Per testare il tuo accesso ai metodi lato Google:

  1. Installa oauth2l.

  2. Ottieni un token di accesso per il tuo account di servizio nel seguente modo. your-service-account-key-file.json è un file chiave del tuo account di servizio.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    Tieni presente che il token di accesso scade dopo circa un'ora. Prima di eseguire di nuovo sopra il comando per un nuovo token di accesso, esegui oauth2l reset per svuotare la cache locale.

  3. Effettua le chiamate di prova come segue. YOUR-ASN deve essere uno degli ASN che ci invii quando abbiamo configurato GTAF durante il processo di integrazione. ACCESS-TOKEN-OBTAINED è l'output del comando superiore a oauth2l fetch. PLAN_STATUS è il corpo della richiesta PlanStatus che vuoi inviare a GTAF.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

Chiamate API di pubblicità programmatica

Segui le istruzioni per effettuare chiamate autorizzate ai metodi lato Google con il seguente ambito OAuth:

https://www.googleapis.com/auth/dataplansharing

Condivisione della proprietà del progetto

La configurazione iniziale prevede un singolo Account Google, ma è consigliabile che un gruppo di utenti autorizzati abbia la proprietà del progetto. In Google Cloud Console, nel menu IAM e amministratore di IAM, puoi aggiungere nuovi membri (incluso l'account Google Gruppi) come proprietari del progetto.