자주 묻는 질문(FAQ)

일반

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

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

이 API를 사용하여 실적 데이터를 가져올 수 있나요?

아니요. Bid Manager API를 사용하여 Display & Video 360 오프라인 보고서를 만들고, 가져오고, 실행합니다.

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 사용자가 다음 사용자 역할 중 하나를 보유해야 합니다.

  • 읽기 전용: user 리소스를 제외하고 get 또는 list 호출을 사용하여 리소스를 검색합니다.
  • 표준: 리소스를 가져오고, 만들고, 업데이트합니다. 동일한 파트너 또는 광고주에 대한 권한이 있는 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 인터페이스에서 파일을 업데이트하면 됩니다.

지원

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

프로젝트에서 초당 실행할 수 있는 요청 수에는 한도가 있으며 이는 사용량 한도 가이드에 설명되어 있습니다.