프로젝트에서 Video Stitcher API를 사용 설정하려면 계정 담당자 또는 영업팀에 문의하여 자세히 알아보세요.

실시간 스트림 이벤트 구성 만들기

Ad Manager 통합에서는 특정 라이브 스트림 이벤트에 대한 라이브 구성을 만들어야 합니다. Video Stitcher API로 이 구성을 Ad Manager에 등록합니다.

슬레이트 만들기

슬레이트를 만들어야 실시간 구성을 만들 수 있습니다. Video Stitcher API는 광고를 삽입할 수 없을 때 기본 슬레이트 동영상을 삽입합니다. 광고가 없을 때 사용할 슬레이트를 나타내기 위해 Video Stitcher API를 사용하여 슬레이트 동영상을 등록해야 합니다. 슬레이트 동영상은 오디오 트랙이 최소 하나 이상 포함된 MP4 파일일 수 있습니다.

이 슬레이트를 만드는 방법에는 두 가지가 있습니다. Ad Manager 계정에 기본 네트워크 슬레이트를 만들거나 Video Stitcher API를 사용하여 슬레이트를 만들 수 있습니다.

Ad Manager에서 슬레이트 만들기

Ad Manager 계정에 기본 네트워크 슬레이트를 만들려면 콘텐츠 빈자리를 채울 슬레이트 만들기의 단계를 수행한 후 라이브 구성 만들기 섹션을 건너뜁니다.

Video Stitcher API를 사용하여 슬레이트 만들기

Video Stitcher API를 사용하여 슬레이트를 만들려면 projects.locations.slates.create 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_NUMBER: Google Cloud 프로젝트 번호입니다. IAM 설정 페이지의 프로젝트 번호 필드에 있습니다.
LOCATION: 슬레이트를 만들 위치입니다. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
SLATE_ID: 슬레이트의 사용자 정의 식별자입니다. 이 ID에는 소문자, 숫자, 하이픈만 포함할 수 있습니다. 첫 번째 글자는 문자여야 하고 마지막 글자는 문자 또는 숫자여야 합니다. 전체 ID는 최대 길이가 63자입니다.
SLATE_URL: 오디오 트랙이 하나 이상 있는 MP4 동영상의 공개 URI입니다(샘플 동영상).
NETWORK_CODE: Ad Manager 네트워크의 숫자 식별자입니다. 게시자 계정의 전역 설정에서 이 옵션을 찾을 수 있습니다.
중요: Google Ad Manager(GAM)에서 슬레이트를 사용할 gamSlate 객체를 포함해야 합니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

cat > request.json << 'EOF'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

@'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "verb": "create"
  },
  "done": false
}

이 명령어는 진행 상황 추적을 쿼리할 수 있는 장기 실행 작업(LRO)을 만듭니다. 다음 섹션에서 사용할 name 필드의 마지막 부분인 반환된 OPERATION_ID를 복사합니다.

결과 확인

슬레이트가 생성되었는지 확인하려면 projects.locations.operations.get 메서드를 사용합니다. 응답에 "done: false"가 포함되어 있으면 응답에 "done: true"가 포함될 때까지 명령어를 반복합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_NUMBER: Google Cloud 프로젝트 번호입니다. IAM 설정 페이지의 프로젝트 번호 필드에 있습니다.
LOCATION: 데이터의 위치입니다. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
OPERATION_ID: 작업의 식별자

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "endTime": END_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.Slate",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "uri": "SLATE_URL",
    "gamSlate": {
      "networkCode": "NETWORK_CODE"
      "gamSlateId": "GAM_SLATE_ID"
    }
  }
}

라이브 구성 만들기

구성을 만들려면 projects.locations.liveConfigs.create 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_NUMBER: Google Cloud 프로젝트 번호입니다. IAM 설정 페이지의 프로젝트 번호 필드에 있습니다.
LOCATION: 라이브 구성을 만들 위치입니다. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
LIVE_CONFIG_ID: 라이브 구성의 사용자 정의 식별자입니다. 이 ID에는 소문자, 숫자, 하이픈만 포함할 수 있습니다. 첫 번째 글자는 문자여야 하고 마지막 글자는 문자 또는 숫자여야 합니다. 전체 ID는 최대 길이가 63자입니다.
SOURCE_LIVESTREAM_URI: 라이브 스트림 동영상 매니페스트의 소스 URL입니다. Video Stitcher API에 액세스할 수 있어야 합니다. URL은 공개적으로 액세스할 수 있거나 CDN에 URL 서명이 사용 설정된 경우 등록된 CDN 키가 Video Stitcher API에 제공되어야 합니다. Live Stream API를 사용하여 테스트 라이브 스트림을 만든 경우에는 Cloud Storage 버킷에 있는 main.m3u8 또는 main.mpd 파일에 대한 URI입니다.
AD_TAG_URI: (이 값을 아래의 요청 JSON 코드 블록에 붙여넣습니다.) 광고 서버에서 가져온 광고 메타데이터의 URL입니다. Ad Manager 통합의 경우 유효한 Ad Manager 라이브 동영상 광고 태그여야 합니다. 유효한 광고 태그를 가져오려면 다음 수정을 통해 동영상 및 오디오 광고 태그 생성의 단계를 수행하세요.
- 실시간 트래픽에서 실시간 트래픽을 사용 설정합니다.
- 플레이어 SDK 유형에서 Google IMA SDK를 선택합니다.
- 매개변수 ad_rule=0를 태그에 추가합니다. 예를 들어 끝에 &ad_rule=0을 추가합니다.
SLATE_ID: 병합된 광고가 없을 때 사용할 슬레이트의 ID입니다.
참고: Ad Manager를 사용하여 기본 네트워크 슬레이트를 만든 경우 기본 네트워크 슬레이트를 사용하도록 요청에서 defaultSlate 필드를 삭제하세요.
NETWORK_CODE: Ad Manager 네트워크의 숫자 식별자입니다. 게시자 계정의 전체 설정에서 확인할 수 있습니다.
AD_TRACKING: 스트림의 광고 추적 동작입니다. IMA SDK 통합의 경우 CLIENT를 사용합니다. 나중에 세션별로 이 값을 재정의할 수도 있습니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

cat > request.json << 'EOF'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
EOF

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

@'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
'@  | Out-File -FilePath request.json -Encoding utf8

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
    "verb": "create"
  },
  "done": false
}

Video Stitcher API는 구성을 Ad Manager 계정에 비동기식으로 등록합니다. 몇 분 정도 걸릴 수 있습니다.

이 명령어는 진행 상황 추적을 쿼리할 수 있는 장기 실행 작업(LRO)을 만듭니다. 자세한 내용은 결과 확인을 참조하세요.

구성 가져오기

구성을 가져오려면 projects.locations.liveConfigs.get 메서드를 사용하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_NUMBER: Google Cloud 프로젝트 번호입니다. IAM 설정 페이지의 프로젝트 번호 필드에 있습니다.
LOCATION: 라이브 구성의 위치입니다. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
LIVE_CONFIG_ID: 라이브 구성의 사용자 정의 식별자입니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
    "assetKey": "ASSET_KEY",
    "customAssetKey": "PROJECT_NUMBER-LOCATION-LIVE_CONFIG_ID"
  },
  "state": "READY",
  "adTracking": "CLIENT",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "stitchingPolicy": "CUT_CURRENT"
}

customAssetKey 필드를 찾고 반환된 CUSTOM_ASSET_KEY를 복사합니다. 이후 단계에서 이러한 값을 양방향 미디어 광고(IMA) SDK에 보냅니다.

시작하기 전에

클라이언트 애플리케이션에서 Google Ad Manager를 사용하도록 준비