AdMob API 시작하기

중요: 신규 사용자 역할 및 권한은 AdMob API에서 반환하는 데이터에 영향을 미칩니다. 자세히 알아보기

이 가이드는 AdMob API를 사용하여 프로그래매틱 방식으로 AdMob 계정에 대한 정보를 가져오려는 개발자를 대상으로 합니다.

모든 Google AdMob API 호출은 OAuth2를 통해 승인되어야 앱이 사용자를 대신하여 웹 서비스와 상호작용할 수 있습니다. OAuth2를 사용하면 AdMob API 클라이언트 앱에서 사용자의 사용자 이름이나 비밀번호를 처리하거나 저장하지 않고도 사용자의 AdMob 계정에 액세스할 수 있습니다. 승인 개요는 승인을 참조하세요.

다음 단계를 따라 OAuth2 사용자 인증 정보를 생성하고 첫 번째 요청을 수행합니다.

기본 요건

• Google 계정

• Google AdMob 계정

• REST 기본사항 및 OAuth 2.0으로 요청 승인에 관한 지식

인증 유형 확인

아래 표에서 앱에 가장 적합한 인증 유형을 확인하세요.

OAuth2 인증 유형 선택	판단 기준
데스크톱 앱	모든 AdMob API 계정을 하나의 최상위 관리자 계정을 사용하여 관리하고 있습니다. 처음 사용하거나 가장 간단한 설정으로 빠르게 시작하려는 경우 앱이 한 컴퓨터에서만 Google AdMob 사용자를 인증합니다.
웹 앱	앱에 AdMob API 계정 데이터에 대한 액세스 권한을 부여할 수 있는 사용자로 인증하려고 합니다. 예를 들어 서드 파티 계정을 관리하기 위해 여러 승인 사용자 인증 정보를 쉽게 생성하려고 합니다. 앱에 콜백 URL이 필요합니다. 데스크톱 앱 흐름에서는 콜백 URL이 지원되지 않습니다.

핵심사항: 서버에서 실행할 앱을 개발하는 경우에도 데스크톱 앱 흐름을 선택할 수 있습니다. 차이점은 OAuth 승인이 로컬에서 완료되는지 아니면 원격으로 완료되는지입니다. 데스크톱 흐름에서는 로컬 머신에서 승인을 완료해야 하는 반면 웹 흐름에서는 Google의 승인 서버에서 승인을 완료할 수 있습니다.

프로젝트 만들기

AdMob API를 사용하려면 먼저 Google API 콘솔에서 프로젝트를 만들거나 선택하고 설정 도구를 사용하여 API를 사용 설정해야 합니다. 이 도구는 과정을 안내하고 AdMob API를 자동으로 활성화합니다.

기존 프로젝트에 API 사용 설정

다음 단계는 기존 프로젝트가 있고 프로젝트에서 AdMob API를 수동으로 활성화하려는 사용자에게 적용됩니다.

프로젝트에 API를 사용하려면 다음을 수행하십시오.

1. Open the API Library 의 Google API Console .
2. If prompted, select a project, or create a new one. API Library 는 제품군 및 인기도별로 그룹화 된 사용 가능한 모든 API를 나열합니다.
3. 사용하려는 API가 목록에 표시되지 않으면 검색을 사용하여 찾거나 해당 제품군에서 모두보기를 클릭하십시오.
4. 사용하려는 API를 선택한 다음 사용 버튼을 클릭하십시오.
5. If prompted, enable billing.
6. If prompted, read and accept the API's Terms of Service.

OAuth2 사용자 인증 정보 만들기

다음 안내에서는 설치된 앱 흐름에 사용할 OAuth 2.0 클라이언트 ID를 만드는 과정을 안내합니다.

1. Go to the Credentials page.

2. 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.

   이전에 이 프로젝트에 OAuth 동의 화면을 구성하지 않았다면 지금 구성하도록 안내됩니다. 동의 화면 구성을 클릭합니다. OAuth 2.0 클라이언트 ID를 사용하도록 동의 화면을 구성하는 방법에는 여러 가지가 있습니다.

   1. 사용자 유형을 외부로 설정하고 게시 상태를 게시됨으로 설정합니다.

   2. 또는 사용자 유형을 외부로 설정하고 게시 상태를 테스트로 설정한 후 사용자 추가를 선택하여 테스트 사용자를 추가하여 OAuth 2.0 클라이언트 ID를 사용할 수 있는 액세스 권한을 사용자에게 부여합니다.

      자세한 내용은 OAuth 동의 화면 설정을 참고하세요.

3. 애플리케이션 유형으로 데스크톱 앱 또는 웹 애플리케이션을 선택하고 이름을 지정한 후 만들기를 클릭합니다.

완료되면 OAuth 2.0 클라이언트 ID와 클라이언트 보안 비밀번호가 제공되며, 이 ID를 JSON 형식으로 다운로드하여 나중에 사용할 수 있도록 저장할 수 있습니다.

요청하기

AdMob API는 HTTP 및 JSON에 기반하므로 모든 표준 HTTP 클라이언트에서 요청을 보내고 응답을 파싱할 수 있습니다. 하지만 Google API 클라이언트 라이브러리는 뛰어난 언어 통합, 향상된 보안, 승인된 요청 지원을 제공합니다. 이 클라이언트 라이브러리는 다양한 프로그래밍 언어로 제공되므로 HTTP 요청을 직접 설정하고 응답을 파싱하지 않아도 됩니다.

참고: OAuth 흐름을 처음 활성화하면 AdMob 게시자 ID를 제공하고 브라우저에서 승인 메시지를 수락하라는 메시지가 표시됩니다. 동의하기 전에 AdMob 계정에 액세스할 수 있는 Google 계정으로 로그인했는지 확인하세요. 그러면 앱에서 현재 로그인된 계정을 대신하여 데이터에 액세스할 수 있는 권한이 부여됩니다.

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의 예시를 사용하여 첫 번째 보고서 생성을 요청합니다.

공유 토큰 취소

다음 두 가지 방법으로 공유 토큰을 취소할 수 있습니다.

1. Google 계정 권한 페이지로 이동하여 관련 프로젝트의 액세스 권한을 취소합니다.

2. 또는 Google Identity API를 사용하여 웹 애플리케이션 토큰을 취소할 수 있습니다.