이 가이드는 AdMob API를 사용하여 프로그래매틱 방식으로 관리하려는 개발자를 대상으로 합니다.
앱이 사용자를 대신하여 웹 서비스와 상호작용할 수 있도록 모든 Google AdMob API 호출은 OAuth2를 통해 승인되어야 합니다. OAuth2를 사용하면 AdMob API 클라이언트 앱이 사용자의 사용자 이름이나 비밀번호를 처리하거나 저장하지 않고도 사용자의 AdMob 계정에 액세스할 수 있습니다. 승인에 관한 개요는 승인을 참고하세요.
다음 단계를 수행하여 OAuth2 사용자 인증 정보를 생성하고 첫 번째 요청을 수행합니다.
기본 요건
인증 유형 결정
아래 표에서 앱에 가장 적합한 인증 유형을 확인하세요.
OAuth2 인증 유형 선택 | 판단 기준 |
---|---|
데스크톱 앱 |
|
웹 앱 |
|
프로젝트 만들기
AdMob API를 사용하려면 먼저 Google API 콘솔에서 프로젝트를 만들거나 선택하고 설정 도구를 사용하여 API를 사용 설정해야 합니다. 이 도구는 절차를 안내하고 AdMob API를 자동으로 활성화합니다.
기존 프로젝트에 API 사용 설정
다음 단계는 기존 프로젝트가 있고 AdMob API를 수동으로 활성화하려는 사용자에게 적용됩니다.
프로젝트에 API를 사용하려면 다음을 수행하십시오.
- Open the API Library 의 Google API Console .
- If prompted, select a project, or create a new one. API Library 는 제품군 및 인기도별로 그룹화 된 사용 가능한 모든 API를 나열합니다.
- 사용하려는 API가 목록에 표시되지 않으면 검색을 사용하여 찾거나 해당 제품군에서 모두보기를 클릭하십시오.
- 사용하려는 API를 선택한 다음 사용 버튼을 클릭하십시오.
- If prompted, enable billing.
- If prompted, read and accept the API's Terms of Service.
OAuth2 사용자 인증 정보 만들기
다음 안내는 설치된 앱 흐름과 함께 사용할 OAuth 2.0 클라이언트 ID를 만드는 프로세스를 안내합니다.
- Go to the Credentials page.
사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
이전에 이 프로젝트에 대해 OAuth 동의 화면을 구성하지 않은 경우 지금 구성하라는 메시지가 표시됩니다. 동의 화면 구성을 클릭합니다. OAuth 2.0 클라이언트 ID를 사용하도록 동의 화면을 구성하는 방법에는 여러 가지가 있습니다.
- 사용자 유형을 외부로, 게시 상태를 게시됨으로 설정합니다.
또는 사용자 유형을 외부로, 게시 상태를 테스트로 설정한 다음 사용자 추가를 선택하여 테스트 사용자를 추가하여 OAuth 2.0 클라이언트 ID를 사용할 수 있는 액세스 권한을 부여합니다.
OAuth 동의 화면 설정에 관한 추가 정보를 확인하세요.
애플리케이션 유형으로 데스크톱 앱 또는 웹 애플리케이션을 선택하고 이름을 지정한 다음 만들기를 클릭합니다.
완료되면 OAuth 2.0 클라이언트 ID와 클라이언트 보안 비밀번호가 표시됩니다. 이 정보를 JSON 형식으로 다운로드하여 나중에 사용할 수 있도록 저장할 수 있습니다.
요청하기
AdMob API는 HTTP 및 JSON을 기반으로 작성되었기 때문에 모든 표준 HTTP 클라이언트가 AdMob API에 요청을 보내고 응답을 파싱할 수 있습니다. 그러나 Google API 클라이언트 라이브러리는 더 나은 언어 통합, 향상된 보안, 승인된 요청을 위한 지원을 제공합니다. 클라이언트 라이브러리는 다양한 프로그래밍 언어로 제공되므로 HTTP 요청을 직접 설정하고 응답을 파싱하지 않아도 됩니다.
OAuth 2.0 사용자 인증 정보가 생성되면 AdMob API를 사용할 준비가 됩니다. OAuth 2.0을 사용하여 액세스를 요청하려면 앱에 범위 정보도 필요합니다.
범위 | 의미 |
---|---|
https://www.googleapis.com/auth/admob.readonly |
모든 AdMob 데이터를 확인합니다. 여기에는 계정 정보, 인벤토리 및 미디에이션 설정, 보고서 및 기타 데이터가 포함될 수 있습니다. 결제나 캠페인 세부정보와 같은 민감한 정보는 포함되지 않습니다. |
https://www.googleapis.com/auth/admob.report |
광고 실적 및 수익 보고서를 확인합니다. 게시자 ID, 시간대, 기본 통화 코드를 확인합니다. |
Java, PHP, Python 또는 curl의 예시를 사용하여 보고서를 생성하기 위한 첫 번째 요청을 실행합니다.
공유 토큰 취소
다음 두 가지 방법으로 공유 토큰을 취소할 수 있습니다.
Google 계정 권한 페이지로 이동하여 관련 프로젝트에서 액세스 권한을 취소합니다.
또는 Google ID API를 사용하여 웹 애플리케이션 토큰을 취소할 수 있습니다.