API 워크플로

이 가이드에서는 Display &Video 360에서 입찰 패키지를 만들고, 가져오고, 업데이트하는 일반적인 API 워크플로를 설명합니다.

입찰 패키지 목록 가져오기

LIST API를 호출합니다. external_deal_id로 필터링을 지원합니다.

새 입찰 패키지 만들기

  1. external_deal_id는 고유해야 합니다. external_deal_id로 LIST를 호출하여 ID가 이미 사용되었는지 확인합니다.
  2. Create API를 호출합니다. 고유한 이름이 할당되며, 이 이름을 사용하여 생성된 패키지를 가져올 수 있습니다.
  3. 생성된 입찰 패키지의 세부정보를 확인하려면 Get API 를 호출합니다.
  4. 선택적으로 생성된 패키지의 로고를 업로드합니다.

입찰 패키지 업데이트

  1. 생성된 입찰 패키지 이름을 저장하지 않은 경우 LIST API 로 필터링된 external_deal_id를 호출하여 업데이트할 입찰 패키지를 가져옵니다.
  2. LIST API의 결과를 기반으로 필드를 업데이트합니다.
  3. 입찰 패키지를 업데이트하려면 Patch API 를 호출합니다. updateMask는 필수 항목입니다. 업데이트를 적용할 필드를 나타냅니다. 업데이트할 수 있는 필드만 updateMask에서 설정할 수 있습니다.

베타 프로세스

베타와 정식 버전의 유일한 차이점은 베타 기간 동안 생성된 입찰 패키지의 상태가 DISCOVERY_OBJECT_STATUS_PAUSED로 설정되어야 하며 상태를 업데이트할 수 없다는 것입니다. 일시중지된 패키지는 DV360 UI에 표시되지 않습니다. 이를 통해 거래소는 테스트 패키지를 표시하지 않고도 API 통합을 테스트할 수 있습니다.

베타에서 모든 '실제' 패키지를 일시중지된 상태로 만든 다음 정식 버전에서 한 번에 활성화하는 것이 일반적입니다.

Quota

거래소당 활성 패키지 2,000개

거래소당 일시중지된 패키지 2,000개

이전
개요