이 페이지는 Cloud Translation API를 통해 번역되었습니다.

배경

시작하기 전에

계정 담당자에게 계정에 대한 적절한 권한을 설정해 달라고 요청하세요. 애플리케이션이 액세스할 수 있습니다
Authorized Buyers 개념에 익숙하지 않은 경우 Authorized Buyers 고객센터를 사용자 인터페이스를 사용해 보세요. 애플리케이션이 실시간 입찰을 실행할 것으로 예상되는 경우 RTB 프로토콜 설명서를 참조하세요.
API 콘솔 새 프로젝트를 설정할 수 있습니다 개발자 Google 계정에 로그인하거나 계정을 만듭니다. 그런 다음 프로젝트를 만들고 승인하라는 메시지가 표시됩니다. 확인하시기 바랍니다.

부모 및 자녀 계정

상위 및 하위 계정이 포함된 계정 구조 내에서 작업하는 경우 이러한 계정이 어떻게 변하는지를 이해하고 있다면 상호작용합니다. 다음은 간략한 요약입니다.

하위 계정

하위 계정에 대한 액세스 권한을 부여하는 사용자 인증 정보를 가진 사용자는 조회 및 수정할 수 있습니다. 자녀 계정으로는 다른 하위 계정 또는 상위 계정에 속한 리소스를 보거나 수정할 수 있습니다.

부모 계정

상위 계정에 대한 액세스 권한을 부여하는 사용자 인증 정보가 있는 사용자가 볼 수 있음 연결된 모든 계정 및 상위 계정의 리소스를 하위 계정. 주어진 리소스를 모두 나열하는 작업의 경우, 이 사용자는 계정 및 모든 계정에 대한 데이터가 포함된 응답을 받게 됩니다. 하위 계정. 하위 시트에 대한 리소스를 타겟팅하는 다른 유형의 요청의 경우 상위 계정에서 하위 요소의 accountId 경로 매개변수를 지정해야 합니다. 계정의 accountId이(가) 아닙니다.

REST API 데이터 모델

리소스는 고유 식별자를 갖는 개별 데이터 항목입니다. 이 계정 리소스는 Authorized Buyers 계정 항목을 나타내며 루트입니다. 데이터 클래스입니다. API의 메서드는 계정 리소스 및 계정 리소스 모음에서 확인할 수 있습니다.

계정 리소스에는 계정 ID, 쿠키 매칭에 사용되는 정보, 입찰자 위치, 입찰 요청이 전송되는 URL, Ad Exchange에서 전송할 초당 최대 검색어 수를 지정합니다.

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

입찰자 위치

입찰자 위치는 계정 리소스와 함께 반환되는 구조입니다. 광고 거래소가 입찰 요청을 보내야 하는 URL과 최대 쿼리 수입니다. 다음은 JSON으로 표현된 입찰자 위치의 예는 다음과 같습니다.

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

항목

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

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

지원되는 작업

Google Cloud 콘솔의 컬렉션과 리소스에 대해 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 작업.

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를 참조하세요.