배경

시작하기 전에

  1. 계정 담당자에게 문의하여 애플리케이션에서 액세스할 계정에 적절한 권한을 설정하세요.
  2. Authorized Buyers 개념에 익숙하지 않은 경우 Authorized Buyers 고객센터를 방문하여 사용자 인터페이스를 실험해 보세요. 애플리케이션이 실시간 입찰을 실행할 것으로 예상되는 경우 RTB 프로토콜 문서를 읽어보세요.
  3. API 콘솔로 이동하여 새 프로젝트를 설정하세요. 개발자 Google 계정에 로그인하거나 계정을 만드세요. 그러면 프로젝트를 만들고 몇 가지 서비스 약관에 동의하라는 메시지가 표시됩니다.

부모 및 자녀 계정

상위 및 하위 계정이 포함된 계정 구조 내에서 작업하는 경우 상위 계정과 하위 계정이 상호작용하는 방식을 이해하면 더 효과적으로 작업할 수 있습니다. 다음은 간략한 요약입니다.

하위 계정

하위 계정에 액세스 권한을 부여하는 사용자 인증 정보가 있는 사용자는 자신의 계정과 연결된 리소스만 보고 수정할 수 있습니다. 하위 계정은 다른 하위 계정 또는 상위 계정에 속한 리소스를 보거나 수정할 수 없습니다.

상위 계정

상위 계정에 액세스 권한을 부여하는 사용자 인증 정보가 있는 사용자는 연결된 모든 하위 계정 외에도 상위 계정의 리소스를 보고 수정할 수 있습니다. 지정된 리소스를 모두 나열하는 작업의 경우 이 사용자는 자신의 계정 및 모든 하위 계정의 데이터가 포함된 응답을 받습니다. 하위 시트의 리소스를 타겟팅하는 다른 유형의 요청의 경우 상위 계정이 자체 accountId 대신 하위 계정의 accountId 경로 매개변수를 지정해야 합니다.

REST API 데이터 모델

리소스는 고유한 식별자가 있는 개별 데이터 항목입니다. 계정 리소스는 Authorized Buyers 계정 항목을 나타내며, Ad Exchange Buyer API의 루트 데이터 클래스입니다. API의 메서드는 개별 계정 리소스 및 계정 리소스 모음에서 작동합니다.

계정 리소스에는 계정 ID, 쿠키 매칭에 사용되는 정보, 입찰자 위치, 입찰 요청을 전송할 URL, 광고 거래소에서 전송할 초당 최대 쿼리 수를 지정하는 요청이 포함됩니다.

Ad Exchange 구매자 API는 계정 리소스 및 컬렉션 외에도 다음과 같은 데이터 구조를 정의합니다.

입찰자 위치

입찰자 위치는 광고 거래소에서 입찰 요청을 전송해야 하는 URL과 광고 거래소에서 전송해야 하는 초당 최대 쿼리 수를 제공하기 위해 계정 리소스와 함께 반환되는 구조입니다. 다음은 JSON으로 표현된 입찰자 위치의 예입니다.

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

항목

항목은 계정 목록을 제공합니다. 다음은 JSON으로 표현된 항목의 예입니다.

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

지원되는 작업

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

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

통화 스타일

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

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

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

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

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

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

HTTP 1.1 표준 문서의 메서드 정의를 확인하면 유용합니다. 문서에 GET, POST, PUT, DELETE의 사양이 포함되어 있습니다.

Ad Exchange 구매자 API의 REST

지원되는 작업은 API 작업에 설명된 대로 REST HTTP 동사에 직접 매핑됩니다.

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

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

여기서 resourceID는 계정 리소스의 식별자이고 parameters는 쿼리에 적용할 매개변수입니다. 자세한 내용은 표준 쿼리 매개변수참조 문서를 확인하세요.

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

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

API에서 지원되는 각 작업에 사용되는 전체 URI 집합은 참조 문서에 요약되어 있습니다.

다음은 Ad Exchange 구매자 API에서 이 과정이 작동하는 방식의 예입니다.

인증된 사용자의 계정 목록 가져오기:

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

데이터 형식

JSON

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