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

VOD 세션 구성 만들기

Ad Manager 통합의 경우 VOD 세션의 광고 태그를 만들어야 합니다. VOD 구성도 만들어야 합니다. Video Stitcher API에서 이 구성을 Ad Manager에 등록합니다.

Ad Manager에서 광고 태그 만들기

Ad Manager 계정에서 다음 단계를 수행합니다.

새 광고 단위를 추가합니다.
광고 규칙을 활성화합니다.
새 광고 규칙을 만듭니다. 이 단계의 일부로 Ad Manager에서 타겟팅 > 인벤토리 섹션을 찾습니다. 이전 단계에서 새 광고 단위를 선택합니다.
다음 수정을 통해 동영상 및 오디오 광고 태그 생성의 단계를 수행하여 유효한 광고 태그를 만듭니다.
- 플레이어 SDK 유형에 Google IMA SDK를 선택합니다.
- ad_rule=1 매개변수를 태그에 추가합니다(예: &ad_rule=1을 끝에 추가).
- vid_d=vod-asset-duration-in-secs 파라미터를 태그에 추가합니다(예: &vid_d=1800을 30분 VOD 애셋 끝에 추가).
- output=vast 매개변수를 output=xml_vmap1로 수정합니다. 동영상 다중 광고 재생목록(VMAP) 사양은 지원되는 유일한 출력 유형입니다.

VOD 구성 만들기

구성을 만들려면 projects.locations.vodConfigs.create 메서드를 사용합니다. 선택적 필드(예: 커스텀 헤더)는 VOD 구성 참고 문서를 참조하세요.

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

PROJECT_NUMBER: Google Cloud 프로젝트 번호입니다. IAM 설정 페이지의 프로젝트 번호 필드에 있습니다.
LOCATION: VOD 구성을 만들 위치입니다. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
VOD_CONFIG_ID: VOD 구성의 사용자 정의 식별자입니다. 이 ID에는 소문자, 숫자, 하이픈만 포함할 수 있습니다. 첫 번째 글자는 문자여야 하고 마지막 글자는 문자 또는 숫자여야 합니다. 전체 ID는 최대 길이가 63자입니다.
VOD_URI: 병합할 미디어의 URI입니다. 이 URI에서 MPEG-DASH 매니페스트(MPD) 파일이나 HLS 매니페스트(M3U8) 파일을 참조해야 합니다. 공개 URI 또는 CDN 키를 등록한 서명되지 않은 URI를 사용합니다.
참고: Transcoder API를 사용하여 이러한 매니페스트 파일을 만들 수 있습니다. 자세한 내용은 VOD 소스 파일 만들기를 참조하세요. Video Stitcher API에서 액세스할 수 있도록 매니페스트 파일을 공개해야 합니다.
```
AD_TAG_URI
```
광고 서버에서 가져온 광고 메타데이터의 URL입니다. Ad Manager 통합의 경우 유효한 Ad Manager 동영상 광고 태그여야 합니다. 유효한 광고 태그를 가져오려면 이전 Ad Manager에서 광고 태그 만들기 섹션의 단계를 수행합니다.
NETWORK_CODE: Ad Manager 네트워크의 숫자 식별자입니다. 게시자 계정의 전체 설정에서 이를 확인할 수 있습니다.

JSON 요청 본문:

{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}

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

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'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "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/vodConfigs?vodConfigId=VOD_CONFIG_ID"

PowerShell(Windows)

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

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

@'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "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/vodConfigs?vodConfigId=VOD_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/vodConfigs/VOD_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "done": false
}

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

결과 확인

projects.locations.operations.get 메서드를 사용하여 VOD 구성이 생성되었는지 확인합니다. 응답에 "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/vodConfigs/VOD_CONFIG_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.VodConfig",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "sourceUri": "VOD_URI",
    "adTagUri": "AD_TAG_URI",
    "gamVodConfig": {
      "networkCode": "NETWORK_CODE"
    },
    "state": "READY"
  }
}

state가 READY로 설정되어 있는지 확인합니다. 그렇지 않으면 몇 초 정도 기다린 후 요청을 다시 보냅니다.

VOD 구성에 대한 자세한 내용은 VOD 구성 만들기 및 관리를 참조하세요.

개요

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