직접 요청하기

구현을 위해 클라이언트 라이브러리 및 샘플을 사용하는 것을 권장합니다. 그러나 API와의 통합에서 지원되지 않는 언어 사용 등의 특별한 요구가 있는 경우, 아래에서 설명된 대로 직접 요청할 수 있습니다.

목차

호출 스타일

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에 대한 개요를 잘 설명하고 있음
  • HTTP 1.1 메소드 정의 - GET, POST, PUTDELETE의 사양이 설명되어 있음

애드센스 관리 API의 REST

지원되는 각 연산에는 애드센스 관리 API 연산에 설명된 대로 1:1로 매핑되는 REST HTTP 용어가 있습니다.

애드센스 관리 API URI에서 사용하는 형식은 다음과 같습니다.

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

여기서 resourceID는 광고 클라이언트, 광고 단위, URL 채널, 맞춤 채널 또는 보고서 컬렉션의 ID이며, parameters는 쿼리에 적용되는 매개변수입니다.

resource ID 형식의 경로 확장을 통해 현재 연산의 리소스를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

https://www.googleapis.com/adsense/v1.4/adclients
https://www.googleapis.com/adsense/v1.4/adclients/adClientId
https://www.googleapis.com/adsense/v1.4/adclients/adClientId/adunits
https://www.googleapis.com/adsense/v1.4/adclients/adClientId/adunits/adUnitId
https://www.googleapis.com/adsense/v1.4/adclients/adClientId/urlchannels
...

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

다음은 애드센스 관리 API에서 이 URI가 사용되는 방식의 몇 가지 예입니다.

광고 클라이언트 나열:

GET https://www.googleapis.com/adsense/v1.4/adclients/

ca-pub-1234567890123456 광고 클라이언트의 광고 단위 나열:

GET https://www.googleapis.com/adsense/v1.4/adClients/ca-pub-1234567890123456/adunits

데이터 형식

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

요청 승인하기

애플리케이션에서 애드센스 관리 API로 전송하는 모든 요청에는 승인 토큰이 포함되어야 합니다. 또한 이 토큰이 있어야 Google에서 애플리케이션을 식별할 수 있습니다.

승인 프로토콜 정보

애플리케이션은 요청을 승인하기 위해 OAuth 2.0을 사용해야 합니다. 기타 승인 프로토콜은 지원되지 않습니다.

OAuth 2.0으로 요청 승인

애드센스 관리 API에 대한 모든 요청은 인증된 사용자의 승인을 받아야 합니다.

OAuth 2.0의 자세한 승인 과정 또는 '흐름'은 개발하는 애플리케이션의 종류에 따라 조금씩 다릅니다. 일반적으로 다음과 같은 과정을 거치게 됩니다.

  1. 애플리케이션을 만들 때 Google 개발자 콘솔을 사용하여 등록합니다. 이렇게 하면 Google에서 고객 ID 및 고객 암호와 같이 나중에 필요한 정보를 제공합니다.
  2. Google 개발자 콘솔에서 애드센스 호스트 API v4를 활성화합니다. 개발자 콘솔의 목록에 해당 API가 없는 경우 이 단계를 건너뛰세요.
  3. 애플리케이션에서 사용자 데이터에 액세스해야 할 경우 Google에 특정 범위의 액세스를 요청합니다.
  4. Google은 사용자에게 동의 화면을 표시하며, 사용자 데이터 일부를 요청하는 애플리케이션을 승인할 것인지 묻습니다.
  5. 사용자가 요청을 승인하면 Google은 애플리케이션에 한시적인 액세스 토큰을 제공합니다.
  6. 애플리케이션에서 사용자 데이터를 요청할 때 이 액세스 토큰을 첨부합니다.
  7. Google은 애플리케이션의 요청과 토큰이 유효한 것으로 판단될 경우 요청된 데이터를 반환합니다.

경우에 따라 토큰 갱신을 사용하여 새 액세스 토큰을 가져오는 등의 추가 단계를 거쳐야 할 수 있습니다. 애플리케이션 유형별 승인 과정에 대한 자세한 내용은 Google의 OAuth 2.0 설명서를 참조하세요.

다음은 애드센스 관리 API의 OAuth 2.0 액세스 범위 정보입니다.

범위 의미
https://www.googleapis.com/auth/adsense 애드센스 데이터에 대한 읽기/쓰기 액세스입니다.
https://www.googleapis.com/auth/adsense.readonly 애드센스 데이터에 대한 읽기 전용 액세스입니다.

OAuth 2.0을 사용하여 액세스를 요청하려면 애플리케이션에 범위 정보와 애플리케이션 등록 시 Google이 제공하는 정보(예: 고객 ID 및 고객 암호)가 있어야 합니다.

도움말: Google API 클라이언트 라이브러리는 승인 과정 중 일부를 자동으로 처리할 수 있습니다. 여러 가지 프로그래밍 언어로 제공되므로 자세한 내용은 라이브러리 및 예제 페이지를 참조하세요.

요청 만들기

마지막 단계는 API 요청 만들기입니다. 구체적인 내용은 참조 문서를 참조하세요.