시작하기

이 문서에서는 Ad Exchange 구매자 REST API를 사용하여 DoubleClick Ad Exchange와 상호작용하는 애플리케이션을 작성하는 방법을 설명합니다. 실시간 입찰 애플리케이션에서 Ad Exchange 구매자 REST API를 사용하여 계정 정보에 액세스하고, 계정 정보를 업데이트하고, 광고 소재를 제출할 수 있습니다. 또한 애플리케이션에서 고정 입찰을 수행하는지 아니면 실시간 입찰을 수행하는지 여부에 관계없이 판매자가 제공하는 직거래를 검색할 수 있습니다.

시작하기 전에 해야 할 일

  1. 계정 담당자에게 귀하의 애플리케이션이 액세스할 계정에 대해 적절한 권한을 설정해 달라고 요청하세요.
  2. Ad Exchange 구매자 개념을 잘 모르는 경우 DoubleClick Ad Exchange 도움말을 읽고 사용자 인터페이스를 확인해 보세요. 애플리케이션이 실시간 입찰을 실행할 것으로 예상되는 경우 Ad Exchange RTB Protocol 설명서를 보세요.
  3. API 콘솔에서 새 프로젝트를 설정하세요. 개발자 Google 계정에 로그인하거나 새 계정을 만듭니다. 이렇게 하면 프로젝트를 만들고 몇 가지 서비스 약관을 수락하라는 메시지가 표시됩니다.

기본 정보

REST API 데이터 모델

리소스는 고유 식별자를 갖는 개별 데이터 항목입니다. Accounts 리소스는 Ad Exchange 구매자 계정 항목을 나타내며, Ad Exchange 구매자r REST API에 대한 루트 데이터 클래스입니다. API의 메소드는 개별 Accounts 리소스와 Accounts 리소스의 집합을 기반으로 작동합니다.

Accounts 리소스에는 계정 ID, 쿠키 일치에 사용되는 정보, 입찰자 위치, Ad Exchange에서 입찰 요청을 전송할 때의 수신 URL 및 Ad Exchange에서 전송할 초당 최대 쿼리 수를 지정하는 요청이 포함됩니다.

Ad Exchange 구매자 REST API는 Accounts 리소스 및 모음뿐 아니라 다음과 같은 데이터 구조를 정의합니다.

입찰자 위치

입찰자 위치는 Accounts 리소스와 함께 반환되는 구조체로서 Ad Exchange에서 입찰 요청을 전송할 URL 및 Ad Exchange에서 전송할 초당 쿼리 검색 수를 제공합니다. JSON으로 표현한 입찰자 위치의 예는 다음과 같습니다.

  "bidderLocation": [
    {
      "url": "http://bid.url.com/bidder",
      "maximumQps": 1500
    }
  ],
항목

항목은 계정 목록을 제공합니다. JSON으로 표현한 항목의 예는 다음과 같습니다.

{
  "kind": "adexchangebuyer#accountsList",
  "items": [
    accounts Resource
  ]
}

지원되는 연산

아래 표의 설명에 따라 Ad Exchange 구매자의 컬렉션 및 리소스를 대상으로 세 가지 메소드를 호출할 수 있습니다. 모든 연산은 승인이 필요합니다.

작업 설명 REST HTTP 매핑
list 현재 인증된 사용자가 액세스할 수 있는 모든 계정을 나열합니다.컬렉션 URI의 GET
get 특정 계정 리소스를 가져옵니다.리소스 URI의 GET
update 특정 계정 리소스를 업데이트합니다.업데이트된 리소스에 대한 데이터를 전송하는 리소스 URI의 PUT

호출 스타일

REST는 데이터 요청 및 수정에 대한 간편하고 일관적인 접근 방식을 제공하는 소프트웨어 아키텍처 스타일입니다.

REST는 'Representational State Transfer'(표현 상태 전송)의 줄임말로, Google API의 맥락에서 REST는 HTTP 동사를 사용하여 Google이 저장한 데이터 표현을 검색 및 수정하는 방법을 의미합니다.

REST식 시스템에서는 리소스가 데이터 저장소에 저장되고, 클라이언트는 서버에서 특정 작업(리소스 생성, 검색, 업데이트, 삭제 등)을 수행하라는 요청을 전송하며, 서버는 작업을 수행하고 응답을 전송합니다. 이 응답은 지정된 리소스 표현의 형식을 취하는 경우가 많습니다.

Google의 REST식 API에서는 클라이언트가 POST, GET, PUT 또는 DELETE 등의 HTTP 동사를 사용하여 작업을 지정합니다. 리소스를 지정할 때 다음과 같은 형식의 고유한 URI를 사용합니다.

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

모든 API 리소스에는 HTTP에서 액세스할 수 있는 고유 URI가 있으므로 REST는 데이터 캐싱을 지원하며 웹 분산형 인프라와의 연동성이 뛰어납니다.

REST에 대한 자세한 내용은 아래와 같은 외부 문서를 참조하세요.

  • Building Web Services the REST Way(REST 방식으로 웹 서비스 구축하기. 서비스 제공업체를 위한 자료이나 REST에 대한 개요를 잘 설명하고 있음.)
  • GET, POST, PUTDELETE의 사양이 설명되어 있는 HTTP 1.1 메소드 정의

Ad Exchange 구매자 REST API의 REST

지원되는 연산은 API 연산에 나온 설명에 따라 REST HTTP 동사로 바로 매핑됩니다.

API URI의 구체적인 형식은 다음과 같습니다.

https://www.googleapis.com/adexchangebuyer/v1.3/resourceID?parameters

여기에서 resourceID는 Accounts 리소스의 식별자이고 parameters 는 쿼리에 적용할 매개변수입니다. 자세히 알아보려면 표준 검색 매개변수참조 설명서를 참조하세요.

resourceID 경로 확장의 형식을 통해 현재 작업 대상인 리소스를 식별할 수 있습니다. 예를 들면 다음과 같습니다.

https://www.googleapis.com/adexchangebuyer/v1.3/accounts
https://www.googleapis.com/adexchangebuyer/v1.3/accounts/id

API에서 지원되는 각 연산에 사용되는 전체 URI는 참조 설명서에 요약되어 있습니다.

Ad Exchange 구매자 API에서 사용하는 방법의 예는 아래와 같습니다.

인증받은 사용자의 계정 목록 가져오기

GET https://www.googleapis.com/adexchangebuyer/v1.3/accounts

데이터 형식

JSON

JSON(JavaScript Object Notation)은 특정 언어에 의존하지 않는 일반적인 데이터 형식으로, 임의의 데이터 구조를 간단한 텍스트로 표현할 수 있습니다. 자세한 내용은 json.org를 참조하세요.

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

DoubleClick Ad Exchange Buyer REST API