Prima di iniziare

Questa pagina mostra come impostare un progetto Google Cloud e configurare un servizio per accedere al progetto.

Configura un progetto Google Cloud

Segui questi passaggi per configurare un progetto Google Cloud.

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Video Stitcher API.

   Enable the API

5. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Video Stitcher Admin role to the service account.

      To grant the role, find the Select a role list, then select Video Stitcher Admin.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

6. Create a service account key:

   1. In the Google Cloud console, click the email address for the service account that you created.
   2. Click Keys.
   3. Click Add key, and then click Create new key.
   4. Click Create. A JSON key file is downloaded to your computer.
   5. Click Close.

7. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

   Example: Linux or macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

   For example:

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

   Example: Windows

   For PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

   For example:

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

   For command prompt:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

8. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

9. Make sure that billing is enabled for your Google Cloud project.

10. Enable the Video Stitcher API.

    Enable the API

11. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

       Go to Create service account
    2. Select your project.

    3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

       In the Service account description field, enter a description. For example, Service account for quickstart.

    4. Click Create and continue.

    5. Grant the Video Stitcher Admin role to the service account.

       To grant the role, find the Select a role list, then select Video Stitcher Admin.

       Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
    6. Click Continue.

    7. Click Done to finish creating the service account.

       Do not close your browser window. You will use it in the next step.

12. Create a service account key:

    1. In the Google Cloud console, click the email address for the service account that you created.
    2. Click Keys.
    3. Click Add key, and then click Create new key.
    4. Click Create. A JSON key file is downloaded to your computer.
    5. Click Close.

13. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

    Example: Linux or macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Replace KEY_PATH with the path of the JSON file that contains your credentials.

    For example:

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

    Example: Windows

    For PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Replace KEY_PATH with the path of the JSON file that contains your credentials.

    For example:

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

    For command prompt:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Replace KEY_PATH with the path of the JSON file that contains your credentials.

14. Install the Google Cloud CLI.

15. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.
16. Utilizza l'interfaccia a riga di comando gcloud per testare l'ambiente di autenticazione. Verifica che il seguente comando restituisca una stringa di testo senza errori:

    gcloud auth application-default print-access-token

Attiva l'account di servizio

1. Nel terminale, imposta il progetto attivo per i comandi gcloud. Sostituisci YOUR_PROJECT_ID con il tuo ID progetto.

   gcloud config set project YOUR_PROJECT_ID

2. Attiva l'account di servizio. Sostituisci PATH_TO_YOUR_SERVICE_KEY con il percorso del file JSON scaricato nella macchina locale.

   gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY

Utilizzerai questo account di servizio per autorizzare l'accesso e chiamare l'API Video Stitcher.

Crea un account di servizio con autorizzazioni solo per la creazione di sessioni

Poiché un token OAuth verrà passato a un'applicazione client, crea un account di servizio separato con autorizzazioni solo per creare una sessione. In questo modo, un token OAuth compromesso non può compromettere le tue risorse, come le configurazioni VOD/live o le chiavi CDN.

Create a service account:

1. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
2. Select your project.

3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

   In the Service account description field, enter a description. For example, Service account for quickstart.

4. Click Create and continue.

5. Grant the Video Stitcher User role to the service account.

   To grant the role, find the Select a role list, then select Video Stitcher User.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
6. Click Continue.

7. Click Done to finish creating the service account.

   Do not close your browser window. You will use it in the next step.

Create a service account key:

1. In the Google Cloud console, click the email address for the service account that you created.
2. Click Keys.
3. Click Add key, and then click Create new key.
4. Click Create. A JSON key file is downloaded to your computer.
5. Click Close.

Configurazione del live streaming

Se inserisci annunci in un live streaming, segui i passaggi descritti in questa sezione (o consulta i passaggi per i VOD).

Collegare l'account di servizio all'account Ad Manager

Una volta creato l'account di servizio, devi collegarlo al tuo account Ad Manager. Ciò consente all'API Video Stitcher di creare live streaming degli eventi per tuo conto. Per farlo, segui i passaggi per concedere l'accesso al tuo account di servizio:

1. Accedi a Google Ad Manager (GAM).
2. Fai clic su Amministratore > Impostazioni globali.
3. Assicurati che l'accesso API sia abilitato.
4. Fai clic su Aggiungi utente con account di servizio.
5. Compila il modulo, incluso l'indirizzo email dell'account di servizio creato in precedenza.
6. Seleziona un ruolo, che deve includere l'autorizzazione Gestire i contenuti video con l'inserimento di annunci dinamici dall'editor video di Google Cloud. Devi creare un ruolo personalizzato denominato Gestore live streaming specificamente per la gestione di questo account di servizio. Il ruolo personalizzato deve avere almeno le seguenti autorizzazioni:
   • Gestire i contenuti video con l'inserimento di annunci dinamici da Google Cloud Video Stitcher
   • Visualizza creatività (richiesto dall'autorizzazione precedente)
   • Visualizzazione di contenuti video, pacchetti e metadati
   • Visualizzare le origini di contenuto
7. Fai clic su Salva e conferma l'aggiunta dell'account di servizio.

Creare un live streaming

Puoi utilizzare una delle iniziative rapide dell'API Live Stream per configurare un live streaming. Sono supportati i live streaming HLS e MPEG-DASH (vedi il requisiti del manifest di origine). Questa procedura è facoltativo; puoi usare il tuo live streaming.

I comandi iniziali dell'API Live Stream utilizzano le credenziali predefinite dell'applicazione per l'autenticazione, ma puoi utilizzare l'account di servizio già configurato. Per questa opzione, assicurati che l'account di servizio abbia il ruolo Editor live streaming.

Assicurati di mantenere attivo il live streaming. non seguire la procedura descritta Pulisci la sezione finché non avrai terminato il live streaming.

Requisiti del manifest di origine

L'API Video Stitcher registra la configurazione con Ad Manager analizzando il manifest di origine. Il manifest di origine deve avere determinate caratteristiche a seconda sul formato.

HLS

• Il formato del contenitore può essere:
  • MPEG-TS multiplexato
  • MPEG-TS non combinato
  • FMP4 non combinato
• Almeno una rappresentazione nel manifest con quanto segue (correttamente (compilati):
  • codec
  • larghezza di banda

MPEG-DASH

• MPD@type impostato su dinamico (@type="dynamic")
• MPD@profiles include il profilo ISO dal vivo urn:mpeg:dash:profile:isoff-live:2011
• Deve essere multiperiodo, con ogni periodo contenente uno o più gruppi di adattamento
• Ogni set di adattamento contiene una o più rappresentazioni
• Le rappresentazioni contengono o ereditano un SegmentTemplate con l'identificatore $Number$ o $Time$
• @segmentAlignment impostato su true per tutti gli insiemi di adattamento
• Le rappresentazioni non devono essere vuote

Configurazione dello stream VOD

Se inserisci annunci in uno stream VOD, segui i passaggi descritti in questa sezione (o consulta la procedura per un live streaming).

Creare i file di origine VOD

Questo flusso di lavoro richiede un file manifest MPEG-DASH (MPD) o un file HTTP Live File manifest di flussi (HLS) (M3U8) e file di segmento associati. Puoi utilizzare i tuoi file VOD esistenti oppure creare file di origine VOD utilizzando l'API Transcoder.