Accounts

API에는 사용자 계정 목록을 검색하고, 특정 계정을 검색하고, 계정을 업데이트하여 완전히 대체하고, 계정을 업데이트하여 부분적으로 대체(패치)하는 메소드가 있습니다.

사용자의 계정 목록 검색

아래와 같은 형식의 Accounts 리소스 URI에 HTTP GET 요청을 전송하여 인증된 상태의 사용자와 관련된 모든 계정을 검색할 수 있습니다.

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

요청

예를 들면 다음과 같습니다.

GET https://www.googleapis.com/adexchangebuyer/v1.3/accounts?access_token=token

승인 가이드에 나온 단계에 따라 액세스 토큰을 얻을 수 있습니다.

응답

요청에 성공하면 서버가 200 OK HTTP 상태 코드와 계정 데이터를 반환합니다. 다음 섹션의 설명에 따라 반환된 ID를 사용하여 특정 계정의 정보를 얻을 수 있습니다.

{'items': [
  {
  "kind": "adexchangebuyer#account",
  "maximumTotalQps": 100,
  "bidderLocation": [
    {
      "url": "http://test.bidder.com/rtb.py",
      "maximumQps": 90,
      "region": "US_EAST"
    }
  ],
  "cookieMatchingNid": "testnetwork",
  "id": "123456789",
  "cookieMatchingUrl": "http://cookie-match.com/match?id="
  }
  {
  "kind": "adexchangebuyer#account",
  "maximumTotalQps": 120,
  "bidderLocation": [
    {
      "url": "http://test.mybidder.com/myrtb.py",
      "maximumQps": 100
      "region": "US_EAST"
    }
  ],
  "cookieMatchingNid": "mytestnetwork",
  "id": "987654321",
  "cookieMatchingUrl": "http://my-cookie-match.com/match?id="
  }
]
}

특정 계정 검색

아래와 같은 형식의 계정 URI에 HTTP GET 요청을 전송하여 특정 계정에 대한 정보를 검색할 수 있습니다.

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

요청

예를 들면 다음과 같습니다.

GET https://www.googleapis.com/adexchangebuyer/v1.3/accounts/123456789?access_token=token

승인 가이드에 나온 단계에 따라 액세스 토큰을 얻을 수 있습니다.

응답

요청에 성공하면 서버가 200 OK HTTP 상태 코드와 계정 데이터를 반환합니다.

{
  "kind": "adexchangebuyer#account",
  "maximumTotalQps": 100,
  "bidderLocation": [
    {
      "url": "http://test.bidder.com/rtb.py",
      "maximumQps": 90,
      "region": "US_EAST"
    }
  ],
  "cookieMatchingNid": "testnetwork",
  "id": "123456789",
  "cookieMatchingUrl": "http://cookie-match.com/match?id="
}

계정 업데이트(전체 대체)

기존 계정 리소스를 업데이트하여 완전히 대체하는 방법은 다음과 같습니다.

  1. 업데이트할 리소스를 검색합니다.
  2. 변경할 속성을 수정합니다.
  3. 리소스 URI에 PUT 요청을 전송하고 수정된 리소스를 메시지 본문으로 제공합니다.

계정 리소스의 URI 형식은 다음과 같습니다.

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

참고: id, cookieMatchingNidmaximumTotalQps 속성은 읽기 전용입니다. 이러한 속성을 업데이트하려고 하면 오류가 발생합니다.

요청

다음은 계정 리소스를 업데이트하여 완전히 대체하는 PUT 요청의 예(위에서 마지막 단계)입니다.

PUT https://www.googleapis.com/adexchangebuyer/v1.3/accounts/123456789
Authorization: /* auth 토큰을 여기에 입력 */

Content-Type: application/json



{

  "kind": "adexchangebuyer#account",

  "maximumTotalQps": 100,

  "bidderLocation": [

    {

      "url": "http://mytest.bidder.com/rtb.py",

      "maximumQps": 90

      "region": "US_EAST"

    }

  ],

  "cookieMatchingNid": "testnetwork",

  "id": "123456789",

  "cookieMatchingUrl": "http://cookie-match.com/match?id="

}

참고: 사용자가 Ad Exchange 구매자 리소스를 업데이트하려면 인증이 필요하므로 귀하가 PUT 요청과 함께 Authorization HTTP 헤더를 제공해야 합니다.

응답

요청에 성공하면 서버가 200 OK HTTP 상태 코드와 수정된 리소스의 전체 표현을 반환합니다.

패치를 사용한 계정 업데이트(부분 대체)

이 계정 업데이트 메소드는 PUT과 비슷하지만, PATCH는 데이터 전체를 대체하는 대신 부분 업데이트만 적용합니다.

기존 계정 리소스를 업데이트하여 패치하는 방법은 다음과 같습니다.

  1. 업데이트할 리소스를 검색합니다.
  2. 변경할 속성을 수정합니다.
  3. 리소스 URI에 PATCH 요청을 전송하고 수정된 리소스를 메시지 본문으로 제공합니다.

계정 리소스의 URI는 전체 대체 업데이트의 경우와 같습니다.

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

참고: id, cookieMatchingNidmaximumTotalQps 속성은 읽기 전용입니다. 이러한 속성을 업데이트하려고 하면 오류가 발생합니다.

요청

다음은 계정 리소스를 업데이트 및 패치하는 PATCH의 예(위에서 마지막 단계)입니다.

PATCH https://www.googleapis.com/adexchangebuyer/v1.3/accounts/123456789
Authorization: /* auth 토큰을 여기에 입력 */
Content-Type: application/json

{
  "bidderLocation": [
    {
      "url": "http://mytest.bidder.new.com/rtb.py",
      "maximumQps": 90
      "region": "US_EAST"
    }
  ],
}

참고: 사용자가 Ad Exchange 구매자 리소스를 업데이트하려면 인증이 필요하므로 귀하가 PUT 요청과 함께 Authorization HTTP 헤더를 제공해야 합니다.

응답

요청에 성공하면 서버가 200 OK HTTP 상태 코드와 수정된 리소스의 전체 표현을 반환합니다.

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

DoubleClick Ad Exchange Buyer REST API