시작하기 전에

이 페이지에서는 Google Cloud 프로젝트를 설정하고 프로젝트에 액세스하도록 서비스 계정을 구성하는 방법을 보여줍니다.

Google Cloud 프로젝트 설정

다음 단계에 따라 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. gcloud CLI를 사용하여 인증 환경을 테스트합니다. 다음 명령어가 오류 없이 텍스트 문자열을 출력하는지 확인합니다.

    gcloud auth application-default print-access-token

서비스 계정 활성화

1. 터미널에서 gcloud 명령어의 활성 프로젝트를 설정합니다. YOUR_PROJECT_ID를 프로젝트 ID로 바꿉니다.

   gcloud config set project YOUR_PROJECT_ID

2. 서비스 계정을 활성화하세요. PATH_TO_YOUR_SERVICE_KEY를 로컬 머신에 다운로드한 JSON 파일의 경로로 바꿉니다.

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

이 서비스 계정을 사용하여 액세스를 승인하고 Video Stitcher API를 호출합니다.

세션 생성 권한만 있는 서비스 계정 만들기

OAuth 토큰이 클라이언트 애플리케이션에 전달되므로, 사용자는 세션 생성 권한만 있는 별도의 서비스 계정을 만듭니다. 따라서 유출된 OAuth 토큰으로 인해 VOD/라이브 구성 또는 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.

라이브 스트림 설정

라이브 스트림에 광고를 삽입하는 경우 이 섹션의 단계를 수행하거나 VOD 단계를 참조하세요.

Ad Manager 계정에 서비스 계정 연결

서비스 계정이 생성되면 해당 서비스 계정을 Ad Manager 계정에 연결해야 합니다. 이렇게 하면 Video Stitcher API로 사용자 대신 라이브 스트림 이벤트를 만들 수 있습니다. 이렇게 하려면 다음 단계에 따라 서비스 계정에 액세스 권한을 부여합니다.

1. Google Ad Manager(GAM)에 로그인합니다.
2. 관리자 > 전체 설정을 클릭합니다.
3. API 액세스가 사용 설정되어 있는지 확인합니다.
4. 서비스 계정 사용자 추가를 클릭합니다.
5. 이전에 만든 서비스 계정의 이메일 주소를 포함하여 양식을 작성합니다.
6. Google Cloud 동영상 광고 삽입 도구에서 동적 광고 삽입으로 동영상 콘텐츠 관리 권한을 포함해야 하는 역할을 선택합니다. 이 서비스 계정을 관리하기 위해 Live Stream Manager라는 커스텀 역할을 생성해야 합니다. 커스텀 역할에는 최소한 다음 권한이 있어야 합니다.
   • Google Cloud Video Stitcher의 동적 광고 삽입 기능으로 동영상 콘텐츠 관리
   • 광고 소재 보기(이전 권한에 필요)
   • 동영상 콘텐츠, 번들 및 메타데이터 보기
   • 콘텐츠 소스 보기
7. Ad Manager 네트워크에서 팀을 사용하는 경우 서비스 계정 사용자에게 '모든 항목' 팀을 할당해야 합니다.
8. 저장을 클릭하고 서비스 계정 추가를 확인합니다.

라이브 스트림 만들기

Live Stream API 빠른 시작 중 하나를 사용하여 라이브 스트림을 설정할 수 있습니다. HLS 및 MPEG-DASH 라이브 스트림 모두 지원됩니다(소스 매니페스트 요구사항 참조). 이 절차는 선택사항입니다. 자체 기존 라이브 스트림을 사용할 수 있습니다.

Live Stream API 빠른 시작에서는 인증에 애플리케이션 기본 사용자 인증 정보를 사용하지만 이미 설정한 서비스 계정을 사용할 수 있습니다. 이 옵션의 경우 서비스 계정에 실시간 스트림 편집자 역할이 있는지 확인하세요.

라이브 스트림을 활성 상태로 유지해야 합니다. 라이브 스트림을 완료할 때까지 삭제 섹션의 단계를 따르지 마세요.

소스 매니페스트 요구사항

Video Stitcher API는 소스 매니페스트를 파싱하여 Ad Manager에 구성을 등록합니다. 소스 매니페스트에는 형식에 따라 특정 특성이 있어야 합니다.

HLS

• 컨테이너 형식은 다음 중 하나일 수 있습니다.
  • 다중화된 MPEG-TS
  • 다중화되지 않은 MPEG-TS
  • 다중화되지 않은 FMP4
• (속성이 채워진) 다음 필드가 포함된 매니페스트의 변환 하나 이상
  • 코덱
  • bandwidth

MPEG-DASH

• MPD@type을 동적(@type="dynamic")으로 설정
• MPD@profiles에는 ISO 실시간 프로필 urn:mpeg:dash:profile:isoff-live:2011이 포함됩니다.
• 각 기간에 하나 이상의 조정 세트가 포함된 다중 기간이어야 합니다.
• 각 조정 세트에는 하나 이상의 표현이 포함됩니다.
• 표현은 $Number$ 또는 $Time$ 식별자가 있는 SegmentTemplate을 포함하거나 상속합니다.
• 모든 조정 세트에서 true로 설정된 @segmentAlignment
• 표현은 비어 있으면 안 됩니다.

VOD 스트림 설정

VOD 스트림에 광고를 삽입하는 경우 이 섹션의 단계를 수행하거나 라이브 스트림 단계를 참조하세요.

VOD 소스 파일 만들기

이 워크플로에는 MPEG-DASH 매니페스트(MPD) 파일 또는 HTTP 라이브 스트리밍(HLS) 매니페스트(M3U8) 파일 그리고 연관된 세그먼트 파일이 필요합니다. 자체 기존 VOD 파일을 사용하거나 Transcoder API를 사용하여 VOD 소스 파일 만들기를 수행할 수 있습니다.