이 가이드는 AdMob API를 사용하여 프로그래매틱 방식으로 AdMob 계정에 대한 정보를 가져오려는 개발자를 대상으로 합니다.
모든 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와 클라이언트 보안 비밀번호가 제공되며, 이 ID를 JSON 형식으로 다운로드하여 나중에 사용할 수 있도록 저장할 수 있습니다.
요청하기
AdMob API는 HTTP 및 JSON에 기반하므로 모든 표준 HTTP 클라이언트에서 요청을 보내고 응답을 파싱할 수 있습니다. 하지만 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, 시간대, 기본 통화 코드를 확인하세요. |
자바, PHP, Python 또는 curl의 예시를 사용하여 첫 번째 보고서 생성을 요청합니다.
공유 토큰 취소
다음 두 가지 방법으로 공유 토큰을 취소할 수 있습니다.
Google 계정 권한 페이지로 이동하여 관련 프로젝트의 액세스 권한을 취소합니다.
또는 Google Identity API를 사용하여 웹 애플리케이션 토큰을 취소할 수 있습니다.