Collect the required information for your client applications
You should have the following information that is required for Google Ad Manager to create a VOD asset session:
| Field | Description |
|---|---|
projectNumber
|
The Google Cloud project number
( PROJECT_NUMBER
)
used to create Ad Manager-enabled sessions; alternatively,
you can use the project ID. |
region
|
The location
( LOCATION
)
that you want the IMA SDK to use to create the VOD session. |
vodConfigId
|
The
VOD configuration ID used to
register the VOD stream with the Video Stitcher API. The following
shows the format for the full config resource name:projec ts / PROJECT_NUMBER /loca t io ns / LOCATION /vodCo nf igs/ VOD_CONFIG_ID VOD_CONFIG_ID
).
Keep in mind that the location of the
config must be in the same location in which you create the VOD session. |
networkCode
|
The numeric identifier
( NETWORK_CODE
) for
your Ad Manager network. |
oAuthToken
|
A short-lived OAuth token for the service account with the Video Stitcher User role. See Generate short-lived OAuth tokens . |
Table 1.Required information for Ad Manager-enabled VOD asset sessions
Generate short-lived OAuth tokens for testing
To generate a short-lived OAuth token associated with the service account with the Video Stitcher Userrole, follow these steps:
- Replace
PATH_TO_YOUR_SERVICE_KEYwith the path to the JSON file you downloaded to your local machine.gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
- Retrieve the OAuth 2.0 bearer token from the service account:
gcloud auth print-access-token
Because this is a short-lived token, you need to generate it again
periodically with the gcloud auth print-access-token
command and send the new
tokens to your client applications. See the following section for more
information on building a production service to provide short-lived tokens.
Create a service to provide information to your client applications
Create a service that can provide the required information to be passed to the client. When the application requests information from your service on how to play a VOD asset, the service should return the information described in Table 1 .
In particular, the service must be able to provide OAuth tokens to client applications in a secure manner. Configure this service using two service accounts, one impersonating the other . One service account has the Service Token Creatorrole and creates an OAuth token for the service account that has the Video Stitcher Userrole. For example:
- Service account 1: This is the caller service account. This account has the Service Token Creatorpermission on service account 2 and impersonates service account 2 to client applications.
- Service account 2: This is the privilege-bearing service account that has the Video Stitcher Userrole to create sessions.
For information on providing an OAuth token from your service, including client library code samples, see Create a short-lived access token .
