자주 묻는 질문(FAQ)

일반

최신 버전의 API는 무엇인가요?

이 문서에서 다루는 최신 버전의 API는 v3입니다.

이 API를 사용하여 성능 데이터를 검색할 수 있나요?

아니요. Display & Video 360 오프라인 보고서를 생성, 검색, 실행하려면 Bid Manager API를 사용하세요.

API 사용

API에 액세스하려면 어떤 URL을 사용해야 하나요?

https://displayvideo.googleapis.com

어떤 인증 방법이 지원되나요?

OAuth 2.0이 유일하게 지원되는 인증 방법입니다.

Display & Video 360 API 요청은 다음 범위에서 승인되어야 합니다.

  • https://www.googleapis.com/auth/display-video

users 서비스에 대한 요청은 다음 추가 범위에 대해서도 승인되어야 합니다.

  • https://www.googleapis.com/auth/display-video-user-management

코드를 작성하고 싶습니다. 클라이언트 라이브러리는 어디에서 찾을 수 있나요?

클라이언트 라이브러리 가이드를 참조하세요.

클라이언트 라이브러리를 사용하지 않으려면 어떻게 해야 하나요?

클라이언트 라이브러리 중 하나를 사용하는 것이 좋지만 직접적인 HTTP 요청을 사용하여 Display & Video 360 API와 상호작용할 수도 있습니다.

advertisers.assets.upload 및 media.upload와 같이 복잡한 일부 메서드는 HTTP 요청으로 직접 변환하기가 더 어렵습니다. 광고 소재 및 맞춤 입찰 가이드에서 cURL을 사용한 이러한 메서드에 대한 HTTP 요청의 예를 확인하세요.

어떤 Display & Video 360 권한이 필요한가요?

Display & Video 360 API를 사용하려면 Google 계정을 인증하는 사용자가 관련 파트너 또는 광고주에 액세스할 수 있는 Display & Video 360 사용자여야 합니다.

관련 파트너 또는 광고주가 다음 작업을 하려면 Display & Video 360 사용자에게 다음 사용자 역할 중 하나가 있어야 합니다.

  • 읽기 전용: get 또는 list 호출을 사용하여 리소스를 가져옵니다(user 리소스 제외).
  • 표준: 리소스를 검색, 생성, 업데이트합니다. 동일한 파트너 또는 광고주에 대한 권한이 있는 user 리소스를 검색합니다.
  • 관리자: 리소스를 검색, 생성, 업데이트합니다. 관리하는 파트너 또는 광고주를 위해 user 리소스를 검색, 만들고 액세스 권한을 부여합니다.

API를 사용하여 YouTube + 파트너 리소스를 업데이트하려면 어떻게 해야 하나요?

Display & Video 360 API는 YouTube + 파트너 리소스 생성 또는 업데이트를 지원하지 않습니다. Display & Video 360 인터페이스에서 구조화된 데이터 파일 (SDF)을 업로드하여 YouTube + 파트너 리소스를 일괄 만들거나 업데이트합니다. SDF 업로드 사용 방법에 관한 자세한 내용은 YouTube 및 파트너 리소스에 관한 가이드 페이지를 참고하세요.

지리적 위치를 타겟팅하려면 어떻게 해야 하나요?

다음 타겟팅 유형을 사용하여 지역 타겟팅을 광고 항목에 할당할 수 있습니다.

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST

targetingTypes.targetingOptions.search를 사용하여 처음 세 타겟팅 유형의 타겟팅 옵션 ID를 검색합니다. advertisers.locationLists 서비스를 사용하여 위치 목록 리소스를 가져오고 관리합니다.

또한 TARGETING_TYPE_POI 타겟팅 옵션 ID를 빌드하여 특정 위도-경도 좌표 주변의 근접 반경을 직접 타겟팅할 수도 있습니다.

API를 사용하여 구조화된 데이터 파일 (SDF)을 다운로드할 수 있는데 업로드하려면 어떻게 해야 하나요?

Display & Video 360 API는 SDF 업로드를 지원하지 않습니다. 대신 API에서 제공하는 CREATE, PATCH, DELETE 메서드를 통해 리소스를 관리하는 것이 좋습니다. SDF를 사용하여 리소스를 계속 관리하려면 Display & Video 360 인터페이스에서 SDF 파일을 업데이트하면 됩니다.

지원

API에 알려진 문제나 제한사항이 있나요?

프로젝트에서 초당 요청할 수 있는 요청 수에는 제한이 있으며 그 내용은 사용량 한도 가이드를 참조하세요.