낙타's IT세상

안녕하세요. 낙타입니다.

이번시간에는 Google Adsense Api를 사용하는 방법에 대해서 설명드릴려고 합니다.

Adsense Api에는 여러 기능들이 있는데요.

그중에 제일 많이 사용할 수 있는 일별 수익금액 확인 하는 방법,광고제재등 알림을 받는 방법에 대해서 

PHP로 구현해 보도록 하겠습니다.

먼저 구글 API 콘솔로 가보도록 하겠습니다.

콘솔 API에서 API라이브러리로 가서 Adsense Management API를 선택합니다.

그러면 사용할지 묻는 화면이 나옵니다. 당연히 사용을 클릭합니다.

사용 선택을 하고 나면 Adsense Management API 를 사용할 수 있게 셋팅이 된 것입니다.

이제 OAuth 2.0 인증을 위한 사용자 인증 정보를 만들어야 합니다.

그리고 지금 만들고 있는 API설정 계정은 Adsense 승인 받은 계정이 아니라도 상관없습니다.

나중에 토큰생성할때만 Adsense 승인을 받은 계정으로 로그인하면 됩니다.

사용자 인증 정보를 만들기 위해 클릭을 합니다.

위와같이 php로 구현할꺼니까 웹 애플리케이션으로 지정하고 이름은 애드센스로 정하시면 됩니다.

아래 승인된 자바스크립트 출처는 API를 사용할 URI를 지정해주시고

승인된 리디렉션 URI는 OAuth 2.0 로그인이 끝난후 Call Back URI 를 적어 주시면 됩니다.

만들기를 클릭하면 위 화면과 같이 OAuth 클라이언트가 생성이 됩니다.

이 클라이언트 ID와 클라이언트 보안 비밀번호를 꼭 저장해 놓으세요. 

나중에 API 호출시 필요한 정보입니다.

그런 다음 refresh token을 구해야 합니다.

refresh token을 구하려면

developers.google.com/oauthplayground/ oauthplayground로 갑니다.

왼쪽에는 API를 선택하는 화면입니다.

여기서는 Adsense Management API v1.4 를 선택하고 아래 scope를 선택하면 됩니다.

https://www.googleapis.com/auth/adsense

https://www.googleapis.com/auth/adsense.readonly

그리고 오른쪽에서는 환경설정부분에 Use your own OAuth credentials 체크해주시고

아래 OAuth Client ID, OAuth Client secret 을 적어 줍니다.

이 값은 위에서 구글 API 콘솔에서 얻은 값들을 적어주면 됩니다.

Close로 닫아줍니다.

정상적으로 값을 다 적어준후에 닫으면 왼쪽편에 Authorize APIs 버튼이 활성화 됩니다.

클릭을 해줍니다.

만약 이 오류가 나타난다면 사용자 인증정보 리디렉션 URI값이 없거나 맞지 않을 경우입니다.

다시 한번 확인해 주시면 됩니다. 이 값들이 정상적으로 다 되어 있으면 다음과 같은 화면이 나옵니다.

이 때 애드센스가 정상적으로 진행되고 있는 계정으로 로그인을 하면 됩니다.

정상적으로 로그인이 되면 위 화면이 연속적으로 나옵니다.

끝날때 허용을 클릭하면 다음 화면이 나옵니다.

여기에서 Exchange authorization code for tokens 버튼을 클릭하면 refresh token이 보여집니다.

이 화면에 나타나는 refresh_token 값을 저장해 둡니다.

이 값을 가지고 2부에 php에서 API를 호출해 보겠습니다.

그럼 여기까지 Adsense Management API를 사용하기 위한 준비과정을 알아보았습니다.

API사용을 위한 셋팅을 하고 refresh token값을 얻는것 까지 해서 프로그래밍을 하기 위한 준비는 끝났습니다.

이제 php에서 api를 어떻게 호출하고 사용하는지 알아보도록 하겠습니다.

앞전 시간에는 구글애즈 계정관련 셋팅과 구글 인증 셋팅을 마쳤습니다.

이제 마지막으로 API를 사용해 볼 수 있는 시간입니다.

라이브러리 셋팅과 웹서버 셋팅을 알아보겠습니다.

먼저 구글애즈 API 라이브러리가 있는 곳에서 다운을 받습니다.

https://github.com/googleads/google-ads-php

컴포져로 설치하기전에 확인해야할 요구사항들이 있습니다.

PHP - composer.json 파일에 최소한의 PHP 버전이 설치되어 있어야 합니다.

gRPC - PHP 확장모듈인 grpc 설치가 되어 있어야 합니다.  

sudo pecl install grpc

 grpc  설치를 합니다.

 extension=grpc.so

 php.ini 에 추가합니다.

Protobuf - PHP 확장모듈인 Protobuf가 설치되어야 합니다.

sudo pecl install protobuf

grpc  설치를 합니다.

extension=protobuf.so

 php.ini 에 추가합니다.

1. 요구사항을 다 설치한후 다운로드 받은후 웹서버 루트에서 압축을 풀어줍니다.

# git clone https://github.com/googleads/google-ads-php.git

2. google-ads-php 디렉토리로 변경합니다.

# cd google-ads-php

여러개의 폴더와 파일들이 보입니다.

compser.json - 라이브러리의 요구사항을 포함하는 json 파일

src - 라이브러리 소스 코드

tests - 라이브러리 코드 테스트

examples - 라이브러리를 사용해서 구글애즈 api  사용한 일반적인 예제들

metadata - 소스 코드에서 내부적으로 사용하는 일부 메타데이터 파일

3. composer install 로 컴포져를 설치합니다.

compser install

4. OAuth2 자격 증명을 설정합니다.

- 애드워즈 api에 대한 자격증명이 이미 있는 경우

   기존 adsapi_php.ini 파일을 복사하여 google_ads_php.ini 로 이름을 바꾸고 섹션이름을 [ADWORDS] -> [GOOGLE_ADS]로 바꿉니다.

   파일이 없는 경우 google_ads_php.ini를 홈 디렉토리에 복사합니다. 

- 새로운 자격증명을 사용하여 Google Ads API에 액세스 하는 경우

   샘플 폴더에 있는 google_ads_php.ini 파일을 홈디렉토리에 복사합니다.

   https://developers.google.com/google-ads/api/docs/oauth/cloud-project를  따라 OAuth2 클라이언트 ID 및 비밀번호를 만듭니다.

   AuthenticateInStandaloneApplication 예제를 실행하면 OAuth2 클라이언트 ID와 암호를 입력하라는 메시지가 표시됩니다.

   예제의 마지막 단계에서 출력을 google_ads_php.ini 파일을 홈디렉토리에 복사합니다. 개발자 토큰도 입력하는것을 빼먹지 마세요.

5. GetCampaigns.php 파일을 실행해서 자격 증명이 유효한지 확인합니다.

php examples/BasicOperations/GetCampaigns.php --customerId <YOUR_CUSTOMER_ID>

첫번째 시간에는 API 센터에서 개발자 토큰을 구하는 방법을 알아보았습니다.

두번째 시간에는 API사용을 위한 구글 인증쪽을 알아보겠습니다.

구글 API 콘솔에서 프로젝트를 하나 생성합니다.

저는 google ADS 로 만들었습니다.

그런다음 사용할 API를 선택해 주세요.

다음은 응용프로그램 유형을 선택해야 합니다.

구글애즈 API에는 두가지 앱 유형 옵션이 있습니다.

 - 설치된 애플리케이션(권장)

 - 웹 어플리케이션

유형에 따른 차이는 아래와 같습니다.

앱 유형을 결정했으면 OAuth2 클라이언트 ID와 클라이언트 비밀번호를 생성합니다.

구글 API 콘솔 사용자 인증 정보 페이지로 갑니다.

사용자 인증정보 만들기를 클릭합니다. 팝업 메뉴중에 OAuth 클라이언트 ID 를 선택합니다.

선택하고 나면 동의 화면 구성을 마쳐야 한다고 나옵니다. 동의화면구성을 클릭합니다.

동의화면 구성을 선택하면 내부에서 사용할지 외부에서 사용할지 선택하라고 나옵니다. 보안을 위해 내부에서만 사용하게 선택합니다.

G-Suite로 로그인되어 있지 않으면 내부클릭이 되지 않습니다. 그럴때는 외부로 클릭하시면 됩니다.

간단하게 애플리케이션 이름만 작성하고 저장합니다. 

그리고나서 다시 한번 사용자 인증정보 만들기를 클릭합니다. 팝업 메뉴중에 OAuth 클라이언트 ID 를 선택합니다.

그러면 아까하고 다른 화면이 나옵니다.

동의화면이 설정되었기 때문에 정상적인 OAuth 클라이언트 ID를 만드는 화면이 나옵니다.

어플리케이션 유형은 API를 PHP기반 웹 애플리케이션을 만들려고 하시면 웹 애플리케이션을 선택합니다.

응용프로그램으로 개발하시는 분은 데스크톱 앱을 선택하시면 되겠습니다.

정상적으로 OAuth 클라이언트가 생성된것을 보실 수 있습니다.

이 클라이언트 ID와 비밀번호로 API에 접근하실 수 있습니다. 

안녕하세요. 낙타입니다.

요즘은 네이버광고나 다음광고보다 구글광고가 대세인거 아시죠.

구글광고가 미국 플랫폼이다보니 셋팅하거나 API사용하기가 쉽지가 않습니다.

그러나 하나하나 따라오시면 구글 애즈 API도 쉽게 사용하실 수 있습니다.

제일 먼저 해야할 일은 구글 애즈 관리자 계정을 만드는 일입니다.

1. 구글 애즈 로그인

https://ads.google.com 

2. 상단 메뉴 도구&설정을 클릭하면 그 중 계정엑세스를 클릭합니다.

3. 사용자탭에서 + 버튼을 클릭합니다.

4. 액세스 수준에서 관리를 선택하고 초대할 이메일을 작성합니다.

이메일주소는 사용자가 아닌 관리용 이메일을 작성하시면 됩니다.

초대장을 받으면 관리자계정으로 로그인을 할 수 있습니다.

만약 초대장 메일이 안오거나 셋팅이 안될때는 직접적으로 만드는 방법이 있습니다.

아래 URL로 관리자 계정 만들기를 클릭하시면 됩니다.

https://ads.google.com/home/tools/manager-accounts/

이렇게 관리자 계정을 만들고 나서 

다시 콘솔로 관리자계정으로 로그인합니다.

일반 ads 계정과 관리자 ads 계정을 연결하는 작업이 남았습니다.

계정메뉴를 클릭하고 + 버튼을 클릭합니다.

그러면 하위계정을 추가할 수 있는 화면이 나옵니다.

여기에 일반 ads 계정 ID (XXX-XXX-XXXX)를 입력해서 추가하고 요청보내기를 합니다.

관리자에서는 이렇게 뜨고 일반 ads로 다시 접속합니다.

도구 및 설정 메뉴에 계정 액세스 및 보안 메뉴로 들어갑니다.

관리자탭으로 가보면 관리자가 요청한 링크가 나옵니다. 거기에서 동의 버튼을 클릭하면 관리자가 API로 일반 ads 계정을 관리하실 수 있습니다.

관리자계정과의 연결은 이렇게 끝이 났습니다. 이제 API 센터에 가서 개발자 토큰을 구할 차례입니다.

관리자계정으로 로그인 합니다.

그리고 도구 및 설정메뉴를 클릭하면 API 센터메뉴가 보입니다.

구글애즈 API를 사용하기 위한 개발자 토큰을 여기에서 받을 수 있습니다.

API센터를 클릭하면 아래와 같은 양식이 나옵니다. 회사 정보 및 사용 목적을 입력하고 토큰생성을 클릭하면 

테스트개발용 토큰이 발급됩니다. 아직 API를 사용하지는 못하지만 토큰까지는 발급이 되는 상태입니다.

API 사용은 승인 메일을 받으신후에 사용 가능합니다.

토큰발급을 클릭하면 개발자 토큰을 보실수 있습니다. 이 값을 잘 저장해 놓으셔야 합니다.

이것으로 API 사용을 위한 첫번째 단계가 끝났습니다.

두번째는 구글 인증을 통한 클라이언트 ID생성하는 과정을 설명해 드리겠습니다.

감사합니다.