API 시작하기

이 문서에서는 Google Bid Manager API를 사용하는 앱을 작성하는 방법을 설명합니다. API를 사용하면 쿼리를 관리하고 보고서 메타데이터를 검색할 수 있습니다.

Bid Manager API v2는 사용 가능한 최신 권장 버전입니다.

1. 시작하기 전에

Google Display & Video 360 개념에 익숙하지 않다면 Display & Video 360 고객센터를 읽고 UI를 실험해 보세요.

2. 인증 준비

Bid Manager API를 사용하려면 먼저 설정 도구를 사용해야 합니다. 설정 도구는 Google API 콘솔에서 프로젝트를 만들고, API를 사용 설정하고, 사용자 인증 정보를 만드는 과정을 안내합니다.

아직 사용자 인증 정보를 만들지 않았다면 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭하여 OAuth 2.0 사용자 인증 정보를 만듭니다. 사용자 인증 정보를 만든 후에는 사용자 인증 정보 페이지에 클라이언트 ID가 표시됩니다. 클라이언트 보안 비밀번호, 리디렉션 URI, 자바스크립트 출처 주소, 이메일 주소 등의 세부정보를 보려면 클라이언트 ID를 클릭하세요.

자세한 내용은 요청 승인을 참고하세요.

3. Bid Manager API 호출

아래 탭에서는 다양한 언어로 코딩하기 위한 빠른 시작을 제공합니다. Bid Manager API 예 저장소에서도 이와 유사한 샘플 코드를 찾을 수 있습니다.

Java

  1. 필요한 라이브러리를 가져옵니다.

    import static java.nio.charset.StandardCharsets.UTF_8;
    import com.google.api.client.auth.oauth2.Credential;
    import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp;
    import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
    import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
    import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
    import com.google.api.client.googleapis.util.Utils;
    import com.google.api.services.doubleclickbidmanager.DoubleClickBidManager;
    import com.google.api.services.doubleclickbidmanager.model.ListQueriesResponse;
    import com.google.api.services.doubleclickbidmanager.model.Query;
    import java.io.Reader;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
  2. 클라이언트 보안 비밀 파일을 로드하고 승인 사용자 인증 정보를 생성합니다.

    이 단계를 처음 수행하는 경우 브라우저에서 승인 메시지를 수락하라는 메시지가 표시됩니다. 수락하기 전에 Display & Video 360에 액세스할 수 있는 Google 계정으로 로그인해야 합니다. 앱이 현재 로그인된 계정을 대신하여 데이터에 액세스하도록 승인됩니다.

    // Read client secrets file.
    GoogleClientSecrets clientSecrets;
    try (Reader reader = Files.newBufferedReader(Paths.get(path-to-client-secrets-file), UTF_8)) {
      clientSecrets = GoogleClientSecrets.load(Utils.getDefaultJsonFactory(), reader);
    }
    
    // Generate authorization credentials.
    // Set up the authorization code flow.
    GoogleAuthorizationCodeFlow flow =
        new GoogleAuthorizationCodeFlow.Builder(
            Utils.getDefaultTransport(),
            Utils.getDefaultJsonFactory(),
            clientSecrets,
            oauth-scopes)
        .build();
    
    Credential credential =
        new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");
    
  3. 공인 API 클라이언트를 만듭니다.

    // Create authorized API client.
    DoubleClickBidManager service =
        new DoubleClickBidManager.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
            .setApplicationName("bidmanager-java-installed-app-sample")
            .build();
    
  4. 작업을 실행합니다.

    // Perform an operation.
    // Call the API, getting a list of 10 queries.
    ListQueriesResponse queriesResponse = service.queries().list().setPageSize(10).execute();
    
    // Print them out.
    System.out.println("Id\t\tName");
    if (queriesResponse.getQueries().size() > 0) {
      for (int i = 0; i < queriesResponse.getQueries().size(); i++) {
        Query currentQuery = queriesResponse.getQueries().get(i);
        System.out.printf(
            "%s\t%s%n",
            currentQuery.getQueryId(),
            currentQuery.getMetadata().getTitle());
      }
    } else {
      System.out.println("No queries exist.");
    }
    

자바에서 Bid Manager API를 사용하는 방법에 관한 자세한 내용은 Bid Manager API 예리드미 파일을 참조하세요.

Python

  1. 필요한 라이브러리를 가져옵니다.

    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient import discovery
    
  2. 클라이언트 보안 비밀 파일을 로드하고 승인 사용자 인증 정보를 생성합니다.

    이 단계를 처음 수행하는 경우 브라우저에서 승인 메시지를 수락하라는 메시지가 표시됩니다. 수락하기 전에 Display & Video 360에 액세스할 수 있는 Google 계정으로 로그인해야 합니다. 앱이 현재 로그인된 계정을 대신하여 데이터에 액세스하도록 승인됩니다.

    # Set up a flow object to create the credentials using the
    # client secrets file and OAuth scopes.
    credentials = InstalledAppFlow.from_client_secrets_file(
        path-to-client-secrets-file, oauth-scopes).run_local_server()
    
  3. 공인 API 클라이언트를 만듭니다.

    # Build the discovery document URL.
    discovery_url = f'https://doubleclickbidmanager.googleapis.com/$discovery/rest?version=v2'
    
    # Build the API service.
    service = discovery.build(
        'doubleclickbidmanager',
        'v2',
        discoveryServiceUrl=discovery_url,
        credentials=credentials)
    
  4. 작업을 실행합니다.

    # Build and execute queries.listqueries request.
    response = service.queries().list(pageSize='10').execute()
    
    # Print queries out.
    if 'queries' in response:
      print('Id\t\tName')
      for query in response['queries']:
        print('%s\t%s' % (query['queryId'], query['metadata']['title']))
    else:
      print('No queries exist.')
    

Python에서 Bid Manager API를 사용하는 방법에 관한 자세한 내용은 Bid Manager API 예리드미 파일을 참조하세요.

2,399필리핀

이 샘플에서는 기본 제공 웹 서버로 PHP를 실행하고 관련 웹페이지로 리디렉션되도록 사용자 인증 정보를 구성했다고 가정합니다. 예를 들어 index.php 파일의 이 코드는 인증 후 http://localhost:8000로 리디렉션되도록 구성된 다음 명령어와 사용자 인증 정보를 사용하여 실행할 수 있습니다.

php -S localhost:8000 -t ./

  1. Google API PHP 클라이언트를 다운로드하여 설치합니다.

    선호되는 방법은 Composer를 사용하는 것입니다.

    composer require google/apiclient:^2.12.1
    

    설치가 완료되면 자동 로더

    require_once '/path/to/your-project/vendor/autoload.php';
    
    를 포함해야 합니다.

  2. Google_Client 객체를 만듭니다.

    $client = new Google_Client();
    
  3. 클라이언트를 설정하고, 필요한 경우 인증 URL로 리디렉션하고, 액세스 토큰을 가져옵니다.

    이 단계를 처음 수행하는 경우 브라우저에서 승인 메시지를 수락하라는 메시지가 표시됩니다. 수락하기 전에 Display & Video 360에 액세스할 수 있는 Google 계정으로 로그인해야 합니다. 앱이 현재 로그인된 계정을 대신하여 데이터에 액세스하도록 승인됩니다.

    // Set up the client.
    $client->setApplicationName('DBM API PHP Samples');
    $client->addScope(oauth-scope);
    $client->setAccessType('offline');
    $client->setAuthConfigFile(path-to-client-secrets-file);
    
    // If the code is passed, authenticate. If not, redirect to authentication page.
    if (isset($_GET['code'])) {
      $client->authenticate($_GET['code']);
    } else {
      $authUrl = $client->createAuthUrl();
      header('Location: ' . $authUrl);
    }
    
    // Exchange authorization code for an access token.
    $accessToken = $client->getAccessToken();
    $client->setAccessToken($accessToken);
    
  4. Display & Video 360 API 서비스를 위한 클라이언트를 구성합니다.

    $service = new Google_Service_DoubleClickBidManager($client);
    
  5. 작업을 실행합니다.

    // Configure params for the Queries.listqueries request.
    $optParams = array('pageSize' => 10);
    
    // Execute the request.
    $result = $service->queries->listQueries($optParams);
    
    // Print the retrieved queries.
    if (!empty($result->getQueries())) {
      print('<pre><p>Id Name</p>');
      foreach ($result->getQueries() as $query) {
        printf('<p>%s %s</p>', $query->queryId, $query->metadata->title);
      }
      print('</pre>');
    } else {
      print '<p>No queries exist.</p>';
    }
    

PHP와 함께 Bid Manager API를 사용하는 방법에 관한 자세한 내용은 Bid Manager API 예리드미 파일을 참조하세요.

4. 다음 단계

클라이언트 라이브러리를 실행했으므로 이제 참조 문서를 살펴보고 구현 빌드를 시작합니다.

예약된 보고서 활용보고 권장사항 준수에 대한 추가 가이드도 제공됩니다.