YouTube 콘텐츠 소유자 전송

YouTube용 BigQuery Data Transfer Service를 사용하면 YouTube 콘텐츠 소유자 보고서와 관련한 반복적인 로드 작업을 자동으로 예약하고 관리할 수 있습니다.

지원되는 보고서

YouTube 콘텐츠 소유자 보고서용 BigQuery Data Transfer Service는 현재 다음과 같은 보고 옵션을 지원합니다.

YouTube 콘텐츠 소유자 보고서가 BigQuery 테이블 및 뷰로 전송되는 방식에 대한 자세한 내용은 YouTube 콘텐츠 소유자 보고서 변환을 참조하세요.

보고 옵션 지원
지원되는 API 버전 2018년 6월 18일
일정

매일 UTC 기준 오후 2시 45분경

시간은 구성 가능합니다.

새로고침 기간

지난 1일

구성할 수 없음

최대 백필 기간

지난 180일

YouTube는 최대 180일 동안 데이터를 보유합니다. 자세한 내용은 YouTube 보고 API 문서의 Historical data(이전 데이터)를 참조하세요.

시작하기 전에

YouTube 콘텐츠 소유자 전송을 만들기 전에 다음을 수행하세요.

  • BigQuery Data Transfer Service를 사용하는 데 필요한 모든 작업을 완료했는지 확인합니다.
  • YouTube 데이터를 저장할 BigQuery 데이터세트를 만듭니다.
  • YouTube 콘텐츠 소유자 계정이 있는지 확인합니다. YouTube 콘텐츠 소유자는 YouTube 채널과 다릅니다. 관리하는 채널이 여러 개라면 YouTube 콘텐츠 소유자 계정만 보유하게 됩니다.
  • 전송을 만드는 사람에게 다음과 같은 필수 권한이 있는지 확인합니다.
    • YouTube: YouTube 콘텐츠 관리자 또는 YouTube 콘텐츠 소유자. 콘텐츠 관리자에게는 콘텐츠 소유자를 대신해 YouTube 콘텐츠를 관리할 수 있는 권한이 부여됩니다. 콘텐츠 소유자는 하나 이상의 YouTube 채널과 각 채널 내 동영상을 보유한 상위 계정입니다.
    • BigQuery: 전송을 만들기 위한 bigquery.transfers.update 권한과 대상 데이터세트에 관한 bigquery.datasets.update 권한. 사전 정의된 프로젝트 수준 IAM 역할 bigquery.admin에는 bigquery.transfers.updatebigquery.datasets.update 권한이 포함됩니다. BigQuery의 IAM 역할에 대한 자세한 내용은 액세스 제어를 참조하세요.
  • BigQuery 웹 UI를 사용해 전송을 만들려면 권한 창을 볼 수 있도록 bigquery.cloud.google.com에서 팝업을 허용해야 합니다. 전송이 성공하려면 YouTube 보고 데이터를 관리하기 위한 BigQuery Data Transfer Service 권한을 허용해야 합니다.
  • 전송 실행 알림은 현재 알파 버전입니다. Cloud Pub/Sub에서 전송 실행 알림을 설정하려면 pubsub.topics.setIamPolicy 권한이 있어야 합니다. 이메일 알림만 설정한다면 Cloud Pub/Sub 권한은 필요 없습니다. 자세한 내용은 BigQuery Data Transfer Service 실행 알림을 참조하세요.

YouTube 콘텐츠 소유자 전송 설정

YouTube 콘텐츠 소유자 전송을 설정하려면 다음 요소가 필요합니다.

  • 콘텐츠 소유자 ID: YouTube가 제공합니다. 콘텐츠 소유자나 관리자로 YouTube에 로그인하면 URL의 o= 뒤에 ID가 표시됩니다. 예를 들어 URL이 https://youtube.com/dashboard?0=AbCDE_8FghIjK라면 콘텐츠 소유자 ID는 AbCDE_8FghIjK입니다. 콘텐츠 소유자 계정에 대한 자세한 내용은 콘텐츠 관리자 계정 설정 구성을 참조하세요.
  • 테이블 서픽스: 전송을 설정할 때 제공되는 사용자 친화적인 채널 이름입니다. 테이블 이름을 만들 때 이 서픽스가 작업 ID에 추가됩니다(예: [reportTypeId]_[suffix]). 서픽스는 동일한 테이블에 개별 전송이 기록되는 것을 방지하기 위해 사용됩니다. 테이블 서픽스는 같은 데이터세트에 데이터를 로드하는 모든 전송에서 고유해야 하며 결과 테이블 이름의 길이를 최소화하도록 짧은 접미사를 사용해야 합니다.

현재 YouTube 보고 API를 사용하며 기존 보고 작업이 있다면 BigQuery Data Transfer Service는 사용자의 보고 데이터를 로드합니다. 기존 보고 작업이 없다면 전송 설정 시 자동으로 YouTube 보고 작업이 사용 설정됩니다.

YouTube 콘텐츠 소유자 전송을 설정하는 방법:

웹 UI

  1. BigQuery 웹 UI로 이동합니다.

    BigQuery 웹 UI로 이동

  2. 전송을 클릭합니다.

  3. 전송 추가를 클릭합니다.

  4. 새 전송 페이지에서 다음 안내를 따릅니다.

    • 소스에서 YouTube 콘텐츠 소유자 보고서를 선택합니다.
    • 표시 이름에 전송 이름을 입력합니다(예: My Transfer). 전송 이름은 나중에 수정해야 할 경우에 전송을 식별할 수 있는 값이면 됩니다.
    • 일정의 경우 기본값 그대로 두거나 수정을 클릭하여 시간을 변경합니다.

      콘텐츠 소유자 전송 커스텀 일정

    • 대상 데이터세트에서 적절한 데이터세트를 선택합니다.

    • 콘텐츠 소유자 ID에 콘텐츠 소유자 ID를 입력합니다.
    • 테이블 서픽스에 서픽스를 입력합니다(예: MT).
    • BigQuery Data Transfer Service가 사용자를 대신해 YouTube 보고 작업을 관리할 수 있도록 Configure Jobs(작업 구성)를 선택합니다. 현재 계정에 존재하지 않는 YouTube 보고서가 있다면 해당 보고서를 사용할 수 있도록 새로운 보고 작업이 생성됩니다.

      콘텐츠 소유자 전송 기본 일정

    • (선택사항) 고급 섹션을 펼치면 전송의 실행 알림을 구성할 수 있습니다. 전송 실행 알림은 현재 알파 버전입니다.

      • Cloud Pub/Sub 주제주제 이름을 입력합니다(예: projects/myproject/topics/mytopic).
      • 전송 실행 실패 시 이메일 알림을 허용하려면 이메일 알림 전송을 선택합니다.
      • 전송 설정 시 사용 중지됨을 선택하지 않습니다. 기존 전송을 사용 중지하려면 전송 작업을 참조하세요.

        Cloud Pub/Sub 주제

  5. 추가를 클릭합니다.

  6. 메시지가 표시되면 허용을 클릭하여 BigQuery Data Transfer Service에 YouTube 보고 데이터를 조회하고 BigQuery에서 데이터에 액세스하고 관리할 수 있는 권한을 부여합니다. 권한 창을 보려면 bigquery.cloud.google.com에서 팝업을 허용해야 합니다.

    전송 허용

명령줄

bq mk 명령어를 입력하고 전송 생성 플래그 --transfer_config를 지정합니다. 다음 플래그도 필요합니다.

  • --data_source
  • --target_dataset
  • --display_name
  • --params

    bq mk --transfer_config --project_id=[PROJECT_ID] --target_dataset=[DATASET] --display_name=[NAME] --params='[PARAMETERS]' --data_source=[DATA_SOURCE]
    

각 항목의 의미는 다음과 같습니다.

  • --project_id는 프로젝트 ID입니다.
  • --target_dataset는 전송 구성 대상 데이터세트입니다.
  • --display_name은 전송 구성 표시 이름입니다. 전송 이름은 나중에 수정해야 할 경우에 전송을 식별할 수 있는 값이면 됩니다.
  • --params에는 JSON 형식으로 생성된 전송 구성의 매개변수가 포함됩니다(예: --params='{"param":"param_value"}'). YouTube 콘텐츠 소유자 전송에는 content_owner_idtable_suffix 매개변수를 제공해야 합니다. BigQuery 전송 서비스가 사용자를 대신해 YouTube 보고 작업을 관리할 수 있도록 configure_jobs 매개변수를 true로 설정해도 됩니다. 현재 계정에 존재하지 않는 YouTube 보고서가 있다면 해당 보고서를 사용할 수 있도록 새로운 보고 작업이 생성됩니다.
  • --data_source는 데이터 소스(youtube_content_owner)입니다.

--project_id 플래그를 입력하여 특정 프로젝트를 지정할 수도 있습니다. --project_id를 지정하지 않으면 기본 프로젝트가 사용됩니다.

예를 들어 다음 명령어는 콘텐츠 소유자 ID AbCDE_8FghIjK, 테이블 서픽스 MT, 대상 데이터세트 mydataset를 이용해 My Transfer라는 이름의 YouTube 콘텐츠 소유자 전송을 만듭니다. 기본 프로젝트에 전송이 생성됩니다.

bq mk --transfer_config --target_dataset=mydataset --display_name='My Transfer' --params='{"content_owner_id":"abCDE_8FghIjK","table_suffix":"MT","configure_jobs":"true"}' --data_source=youtube_content_owner

API

projects.locations.transferConfigs.create 메소드를 사용하고 TransferConfig 리소스의 인스턴스를 제공합니다.

데이터 쿼리

BigQuery로 전송되는 데이터는 내부 데이터화 시간별로 파티션을 나눈 테이블에 기록됩니다. 자세한 내용은 파티션을 나눈 테이블을 참조하세요.

자동 생성된 보기를 사용하지 않고 직접 테이블을 쿼리하는 경우에는 쿼리에서 _PARTITIONTIME 유사 열을 사용해야 합니다. 자세한 내용은 파티션 테이블 쿼리를 참조하세요.

YouTube 콘텐츠 소유자 전송 설정 문제해결

전송을 설정하는 데 문제가 있다면 BigQuery Data Transfer Service 전송 설정 문제해결YouTube 전송 문제를 참조하세요.

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.