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

직접 요청하기

구현에 클라이언트 라이브러리 및 샘플을 사용하는 것이 좋습니다. 하지만 API와의 통합에 특별한 요구사항이 있는 경우(예: 지원되지 않는 언어 사용) 아래 설명된 대로 직접 요청할 수 있습니다.

통화 스타일

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의 사양이 포함되어 있습니다.

애드센스 관리 API의 REST

애드센스 관리 API 연산에 설명된 대로 지원되는 연산은 REST HTTP 동사에 직접 매핑됩니다.

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

https://adsense.googleapis.com/v2/resourceID?parameters

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

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

https://adsense.googleapis.com/v2/accounts/account_id/adclients
https://adsense.googleapis.com/v2/accounts/account_id/adclients/adClientId
https://adsense.googleapis.com/v2/accounts/account_id/adclients/adClientId/adunits
https://adsense.googleapis.com/v2/accounts/account_id/adclients/adClientId/adunits/adUnitId
https://adsense.googleapis.com/v2/accounts/account_id/adclients/adClientId/urlchannels
...

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

다음은 애드센스 관리 API에서 이 기능이 작동하는 방식의 몇 가지 예입니다.

광고 클라이언트 나열:

GET https://adsense.googleapis.com/v2/accounts/account_id/adclients/

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

GET https://adsense.googleapis.com/v2/accounts/account_id/adclients/ca-pub-1234567890123456/adunits

데이터 형식

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

요청 승인

애드센스는 서비스 계정을 지원하지 않으므로 설치된 애플리케이션 흐름을 사용해야 합니다.

애플리케이션에서 애드센스 관리 API로 전송하는 모든 요청에는 승인 토큰이 포함되어야 합니다. Google은 이 토큰을 사용하여 애플리케이션을 식별합니다.

승인 프로토콜 정보

요청을 승인하려면 애플리케이션에서 OAuth 2.0을 사용해야 합니다. 다른 승인 프로토콜은 지원되지 않습니다. 애플리케이션에서 Google 계정으로 로그인을 사용하는 경우, 승인의 일부 절차는 자동으로 처리됩니다.

OAuth 2.0을 사용하여 요청 승인하기

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

이 프로세스는 OAuth 클라이언트 ID를 사용하여 진행됩니다.

또는 사용자 인증 정보 페이지에서 만드세요.

OAuth 2.0의 세부적인 승인 절차('흐름')는 제작 중인 애플리케이션 종류에 따라 약간씩 다릅니다. 다음의 일반적인 과정은 모든 애플리케이션 유형에 적용됩니다.

애플리케이션에서 사용자 데이터에 액세스해야 하는 경우 Google에 특정 액세스 범위를 요청합니다.
Google에서 사용자에게 애플리케이션이 일부 데이터를 요청하도록 승인할 것인지 물어보는 동의 화면을 표시합니다.
사용자가 승인하면 Google에서 애플리케이션에 제한 시간이 있는 액세스 토큰을 제공합니다.
애플리케이션에서 액세스 토큰을 첨부하여 사용자 데이터를 요청합니다.
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 요청 만들기입니다. 자세한 내용은 참조 문서를 확인하세요.