시작하기

자바

다음은 Java 클라이언트 클라이언트를 사용하여 라이브러리를 사용하여 v3 지도에 통합할 수 있습니다. 자세한 사용 정보는 README 파일을 다운로드할 수 있습니다.

1. 사용자 인증 정보 설정

   셸에서 다음 명령어를 실행합니다.

   curl https://raw.githubusercontent.com/googleads/googleads-java-lib/main/examples/admanager_axis/src/main/resources/ads.properties -o ~/ads.properties

   ~/ads.properties 파일을 열고 다음 필드를 채웁니다. <ph type="x-smartling-placeholder">

   [...]
   api.admanager.applicationName=INSERT_APPLICATION_NAME_HERE
   api.admanager.jsonKeyFilePath=INSERT_PATH_TO_JSON_KEY_FILE_HERE
   api.admanager.networkCode=INSERT_NETWORK_CODE_HERE
   [...]

   </ph>

2. 종속 항목 지정

   pom.xml 파일을 수정하고 다음을 추가합니다. dependencies 태그 에서 최신 버전 번호를 찾을 수 있습니다. GitHub:

   <dependency>
     <groupId>com.google.api-ads</groupId>
     <artifactId>ads-lib</artifactId>
     <version>RELEASE</version>
   </dependency>
   <dependency>
     <groupId>com.google.api-ads</groupId>
     <artifactId>dfp-axis</artifactId>
     <version>RELEASE</version>
   </dependency>

3. 코드를 작성하고 요청하세요.

   import com.google.api.ads.common.lib.auth.OfflineCredentials;
   import com.google.api.ads.common.lib.auth.OfflineCredentials.Api;
   import com.google.api.ads.admanager.axis.factory.AdManagerServices;
   import com.google.api.ads.admanager.axis.v202408.Network;
   import com.google.api.ads.admanager.axis.v202408.NetworkServiceInterface;
   import com.google.api.ads.admanager.lib.client.AdManagerSession;
   import com.google.api.client.auth.oauth2.Credential;
   
   public class App {
     public static void main(String[] args) throws Exception {
       Credential oAuth2Credential = new OfflineCredentials.Builder()
           .forApi(Api.AD_MANAGER)
           .fromFile()
           .build()
           .generateCredential();
   
       // Construct an AdManagerSession.
       AdManagerSession session = new AdManagerSession.Builder()
           .fromFile()
           .withOAuth2Credential(oAuth2Credential)
           .build();
   
       // Construct a Google Ad Manager service factory, which can only be used once per
       // thread, but should be reused as much as possible.
       AdManagerServices adManagerServices = new AdManagerServices();
   
       // Retrieve the appropriate service
       NetworkServiceInterface networkService = adManagerServices.get(session,
           NetworkServiceInterface.class);
   
       // Make a request
       Network network = networkService.getCurrentNetwork();
   
       System.out.printf("Current network has network code '%s' and display" +
           " name '%s'.%n", network.getNetworkCode(), network.getDisplayName());
     }
   }
   

   GitHub에서 보기

Python

다음은 Python 클라이언트 라이브러리를 사용하는 방법을 보여주는 기본적인 예입니다. Python 클라이언트 라이브러리는 Python v3.6 이상을 지원합니다. 자세한 사용 방법은 자세한 내용은 README를 참고하세요. 파일을 다운로드할 수 있습니다.

1. 라이브러리를 설치하고 사용자 인증 정보를 설정합니다.

   셸에서 다음 명령어를 실행합니다.

   pip install googleads
   curl https://raw.githubusercontent.com/googleads/googleads-python-lib/main/googleads.yaml \
        -o ~/googleads.yaml
   

2. ~/googleads.yaml 파일을 설정합니다.

   다음 필드를 입력합니다.

   ad_manager:
     application_name: INSERT_APPLICATION_NAME_HERE
     network_code: INSERT_NETWORK_CODE_HERE
     path_to_private_key_file: INSERT_PATH_TO_FILE_HERE
   

3. 코드를 실행하고 요청합니다.

   # Import the library.
   from googleads import ad_manager
   
   # Initialize a client object, by default uses the credentials in ~/googleads.yaml.
   client = ad_manager.AdManagerClient.LoadFromStorage()
   
   # Initialize a service.
   network_service = client.GetService('NetworkService', version='v202408')
   
   # Make a request.
   current_network = network_service.getCurrentNetwork()
   
   print("Current network has network code '%s' and display name '%s'." %
           (current_network['networkCode'], current_network['displayName']))
   

   GitHub에서 보기

PHP

이것은 인코더-디코더 아키텍처를 PHP 클라이언트 라이브러리.

1. 라이브러리를 설치하고 사용자 인증 정보를 설정합니다.

   셸에서 다음 명령어를 실행하여 클라이언트 라이브러리를 설치하고 adsapi_php.ini 파일을 홈 디렉터리에 복사합니다.

   composer require googleads/googleads-php-lib
   curl https://raw.githubusercontent.com/googleads/googleads-php-lib/main/examples/AdManager/adsapi_php.ini -o ~/adsapi_php.ini

2. ~/adsapi_php.ini 파일 설정

   다음 필드를 입력합니다.

   [AD_MANAGER]
   networkCode = "INSERT_NETWORK_CODE_HERE"
   applicationName = "INSERT_APPLICATION_NAME_HERE"
   
   [OAUTH2]
   jsonKeyFilePath = "INSERT_ABSOLUTE_PATH_TO_OAUTH2_JSON_KEY_FILE_HERE"
   scopes = "https://www.googleapis.com/auth/dfp"
   

3. 코드를 실행하고 요청합니다. <ph type="x-smartling-placeholder">

   <?php
   require 'vendor/autoload.php';
   use Google\AdsApi\AdManager\AdManagerSession;
   use Google\AdsApi\AdManager\AdManagerSessionBuilder;
   use Google\AdsApi\AdManager\v202408\ApiException;
   use Google\AdsApi\AdManager\v202408\ServiceFactory;
   use Google\AdsApi\Common\OAuth2TokenBuilder;
   
   // Generate a refreshable OAuth2 credential for authentication.
   $oAuth2Credential = (new OAuth2TokenBuilder())
       ->fromFile()
       ->build();
   // Construct an API session configured from a properties file and the OAuth2
   // credentials above.
   $session = (new AdManagerSessionBuilder())
       ->fromFile()
       ->withOAuth2Credential($oAuth2Credential)
       ->build();
   
   // Get a service.
   $serviceFactory = new ServiceFactory();
   $networkService = $serviceFactory->createNetworkService($session);
   
   // Make a request
   $network = $networkService->getCurrentNetwork();
   printf(
       "Network with code %d and display name '%s' was found.\n",
       $network->getNetworkCode(),
       $network->getDisplayName()
   );
   

   GitHub에서 보기

.NET

다음은 .NET 클라이언트 보관함

1. 새 프로젝트 생성

   Visual Studio를 열고 새 프로젝트 (콘솔 애플리케이션)를 만듭니다.

2. 프로젝트에 필수 라이브러리 참조 추가

   Google.Dfp의 nuget 종속 항목을 추가합니다.

3. App.config 설정

   src\App.config를 프로젝트 디렉터리에 복사하여 프로젝트에 추가합니다. 애플리케이션에 자체 App.config가 있는 경우 다음 노드를 App.config에 복사할 수 있습니다.

   • configuration/AdManagerApi
   • configuration/configSections/section[name=&quot;AdManagerApi&quot;]
   • configuration/system.net
4. 사용자 인증 정보 설정

   App.config를 열고 다음 키를 수정합니다.

   <add key="ApplicationName" value="INSERT_YOUR_APPLICATION_NAME_HERE" />
   <add key="NetworkCode" value="INSERT_YOUR_NETWORK_CODE_HERE" />
   <add key="OAuth2Mode" value="SERVICE_ACCOUNT" />
   <add key="OAuth2SecretsJsonPath" value="INSERT_OAUTH2_SECRETS_JSON_FILE_PATH_HERE" />
   

5. 라이브러리에 전화 걸기

   다음 C# 코드 스니펫과 같이 라이브러리를 호출할 수 있습니다.

   GitHub에서 보기

   AdManagerUser user = new AdManagerUser();
         using (InventoryService inventoryService = user.GetService<InventoryService>())
               {
                   // Create a statement to select ad units.
                   int pageSize = StatementBuilder.SUGGESTED_PAGE_LIMIT;
                   StatementBuilder statementBuilder =
                       new StatementBuilder().OrderBy("id ASC").Limit(pageSize);
   
                   // Retrieve a small amount of ad units at a time, paging through until all
                   // ad units have been retrieved.
                   int totalResultSetSize = 0;
                   do
                   {
                       AdUnitPage page =
                           inventoryService.getAdUnitsByStatement(statementBuilder.ToStatement());
   
                       // Print out some information for each ad unit.
                       if (page.results != null)
                       {
                           totalResultSetSize = page.totalResultSetSize;
                           int i = page.startIndex;
                           foreach (AdUnit adUnit in page.results)
                           {
                               Console.WriteLine(
                                   "{0}) Ad unit with ID \"{1}\" and name \"{2}\" was found.", i++,
                                   adUnit.id, adUnit.name);
                           }
                       }
   
                       statementBuilder.IncreaseOffsetBy(pageSize);
                   } while (statementBuilder.GetOffset() < totalResultSetSize);
   
                   Console.WriteLine("Number of results found: {0}", totalResultSetSize);
               }
           

App.config에 사용자 인증 정보를 설정하지 않으려면 다음을 참고하세요. 이 위키 문서를 참고하세요. AdManagerUser 클래스를 사용하는 다른 방법을 참조하세요. .NET 클라이언트 라이브러리 사용에 대한 자세한 내용은 README를 참조하세요. 를 참고하세요. 클라이언트 라이브러리 없이 .NET에서 개발하려면 NoClientLibrary 위키 문서를 참고하세요.

Ruby

다음은 Ruby 명령어 사용법을 보여주는 기본적인 예입니다. 클라이언트 라이브러리를 사용합니다. Ruby 클라이언트 라이브러리에는 Ruby 2.1 이상이 필요합니다.

1. Ruby gem을 설치하고 구성 파일 가져오기

   셸에서 다음 명령어를 실행합니다.

   gem install google-dfp-api
   curl https://raw.githubusercontent.com/googleads/google-api-ads-ruby/main/ad_manager_api/ad_manager_api.yml -o ~/ad_manager_api.yml
   

2. 사용자 인증 정보 설정

   ~/ad_manager_api.yml의 필수 필드를 채웁니다. 파일에서 참조됩니다. 아직 OAuth2 키 파일이 없는 경우 OAuth2 계정을 만드는 방법 사용자 인증 정보를 제공합니다.

   :authentication:
     :oauth2_keyfile: INSERT_PATH_TO_JSON_KEY_FILE_HERE
     :application_name: INSERT_APPLICATION_NAME_HERE
     :network_code: INSERT_NETWORK_CODE_HERE
   

3. 코드를 작성하고 요청하세요.

   # Import the library.
   require 'ad_manager_api'
   
   # Initialize an Ad Manager client instance (uses credentials in ~/ad_manager_api.yml by default).
   ad_manager = AdManagerApi::Api.new
   
   # Get a service instance.
   network_service = ad_manager.service(:NetworkService, :v202408)
   
   # Make a request.
   network = network_service.get_current_network()
   
   puts "The current network is %s (%d)." %
           [network[:display_name], network[:network_code]]
   

   GitHub에서 보기

시작하는 방법에 대한 자세한 내용은 README에서 확인할 수 있습니다. 를 사용합니다. 자세한 내용은 예시 라이브러리를 참조하세요.