시작하기

C#

최신 .NET용 Campaign Manager 360 API 클라이언트 라이브러리를 설치합니다. NuGet을 사용하여 설치를 관리하는 것이 좋습니다.

NuGet 패키지 관리자 콘솔을 열고 다음 명령어를 실행합니다.

Install-Package Google.Apis.Dfareporting.v3_4

자세히 알아보기

• Campaign Manager 360 API용 .NET 참조 문서 둘러보기
• .NET용 Google API 클라이언트 라이브러리 개발자 가이드 읽기

자바

최신 자바용 Campaign Manager 360 API 클라이언트 라이브러리를 설치합니다. Maven을 사용하여 설치를 관리하는 것이 좋습니다.

pom.xml 파일에 다음 종속 항목을 추가합니다.

<dependency>
  <groupId>com.google.apis</groupId>
  <artifactId>google-api-services-dfareporting</artifactId>
  <version>v4-rev20250722-2.0.0</version>
  <exclusions>
    <exclusion>
      <groupId>com.google.guava</groupId>
      <artifactId>guava-jdk5</artifactId>
    </exclusion>
  </exclusions>
</dependency>

자세히 알아보기

• Campaign Manager 360 API의 JavaDoc 참조를 둘러보세요.
• 자바용 Google API 클라이언트 라이브러리 개발자 가이드 읽기

PHP

최신 PHP용 Campaign Manager 360 API 클라이언트 라이브러리를 설치합니다. Composer를 사용하여 설치를 관리하는 것이 좋습니다.

터미널을 열고 다음 명령어를 실행합니다.

composer require google/apiclient

라이브러리를 이미 설치했으며 최신 버전으로 업데이트하려면 다음을 실행합니다.

composer update google/apiclient

시스템에 따라 명령어 앞에 sudo를 추가해야 할 수 있습니다.

자세히 알아보기

• PHP용 Google API 클라이언트 라이브러리 개발자 가이드 읽기

Python

최신 Python용 Campaign Manager 360 API 클라이언트 라이브러리를 설치합니다. pip를 사용하여 설치를 관리하는 것이 좋습니다.

터미널을 열고 다음 명령어를 실행합니다.

pip install --upgrade google-api-python-client

시스템에 따라 명령어 앞에 sudo를 추가해야 할 수 있습니다.

자세히 알아보기

• Campaign Manager 360 API의 PyDoc 참조를 둘러보세요.
• Python용 Google API 클라이언트 라이브러리 (v1/v2) 개발자 가이드를 읽습니다.

Ruby

최신 Ruby용 Campaign Manager 360 API 클라이언트 라이브러리를 설치합니다. RubyGems를 사용하여 설치를 관리하는 것이 좋습니다.

터미널을 열고 다음 명령어를 실행합니다.

gem install google-api-client

라이브러리를 이미 설치했으며 최신 버전으로 업데이트하려면 다음을 실행합니다.

gem update -y google-api-client

시스템에 따라 명령어 앞에 sudo를 추가해야 할 수 있습니다.

자세히 알아보기

• Ruby용 Google API 클라이언트 라이브러리 개발자 가이드 읽기

C#

1. 클라이언트 보안 비밀번호 파일을 로드하고 승인 사용자 인증 정보를 생성합니다.

   이 단계를 처음 수행하면 브라우저에서 승인 메시지를 수락하라는 메시지가 표시됩니다. 수락하기 전에 Campaign Manager 360에 액세스할 수 있는 Google 계정으로 로그인했는지 확인하세요. 애플리케이션은 현재 로그인되어 있는 계정을 대신하여 데이터에 액세스할 수 있는 권한을 부여받습니다.

   // Load client secrets from the specified JSON file.
   GoogleClientSecrets clientSecrets;
   using(Stream json = new FileStream(pathToJsonFile, FileMode.Open, FileAccess.Read)) {
     clientSecrets = GoogleClientSecrets.Load(json);
   }
   
   // Create an asynchronous authorization task.
   //
   // Note: providing a data store allows auth credentials to be cached, so they survive multiple
   // runs of the application. This avoids prompting the user for authorization every time the
   // access token expires, by remembering the refresh token. The "user" value is used to
   // identify a specific set of credentials within the data store. You may provide different
   // values here to persist credentials for multiple users to the same data store.
   Task<UserCredential> authorizationTask = GoogleWebAuthorizationBroker.AuthorizeAsync(
       clientSecrets.Secrets,
       OAuthScopes,
       "user",
       CancellationToken.None,
       dataStore);
   
   // Authorize and persist credentials to the data store.
   UserCredential credential = authorizationTask.Result;

2. 승인된 Dfareporting 클라이언트를 만듭니다.

   // Create a Dfareporting service object.
   //
   // Note: application name should be replaced with a value that identifies your application.
   service = new DfareportingService(
       new BaseClientService.Initializer {
         HttpClientInitializer = credential,
         ApplicationName = "C# installed app sample"
       }
   );

3. 작업 실행

   // Retrieve and print all user profiles for the current authorized user.
   UserProfileList profiles = service.UserProfiles.List().Execute();
   
   foreach (UserProfile profile in profiles.Items) {
     Console.WriteLine("Found user profile with ID {0} and name \"{1}\".",
         profile.ProfileId, profile.UserName);
   }

자바

1. 클라이언트 보안 비밀번호 파일을 로드하고 승인 사용자 인증 정보를 생성합니다.

   이 단계를 처음 수행하면 브라우저에서 승인 메시지를 수락하라는 메시지가 표시됩니다. 수락하기 전에 Campaign Manager 360에 액세스할 수 있는 Google 계정으로 로그인했는지 확인하세요. 애플리케이션은 현재 로그인되어 있는 계정을 대신하여 데이터에 액세스할 수 있는 권한을 부여받습니다.

   // Load the client secrets JSON file.
   GoogleClientSecrets clientSecrets =
       GoogleClientSecrets.load(
           jsonFactory, Files.newBufferedReader(Paths.get(pathToClientSecretsFile), UTF_8));
   
   // Set up the authorization code flow.
   //
   // Note: providing a DataStoreFactory allows auth credentials to be cached, so they survive
   // multiple runs of the program. This avoids prompting the user for authorization every time the
   // access token expires, by remembering the refresh token.
   GoogleAuthorizationCodeFlow flow =
       new GoogleAuthorizationCodeFlow.Builder(
               httpTransport, jsonFactory, clientSecrets, OAUTH_SCOPES)
           .setDataStoreFactory(dataStoreFactory)
           .build();
   
   // Authorize and persist credentials to the data store.
   //
   // Note: the "user" value below is used to identify a specific set of credentials in the data
   // store. You may provide different values here to persist credentials for multiple users to
   // the same data store.
   Credential credential =
       new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");

2. 승인된 Dfareporting 클라이언트를 만듭니다.

   // Create a Dfareporting client instance.
   //
   // Note: application name below should be replaced with a value that identifies your
   // application. Suggested format is "MyCompany-ProductName/Version.MinorVersion".
   Dfareporting reporting =
       new Dfareporting.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
           .setApplicationName("dfareporting-java-installed-app-sample")
           .build();

3. 작업 실행

   // Retrieve and print all user profiles for the current authorized user.
   UserProfileList profiles = reporting.userProfiles().list().execute();
   for (int i = 0; i < profiles.getItems().size(); i++) {
     System.out.printf("%d) %s%n", i + 1, profiles.getItems().get(i).getUserName());
   }

PHP

1. 클라이언트 보안 비밀번호 파일을 로드하고 승인 사용자 인증 정보를 생성합니다.

   이 단계를 처음 수행하면 브라우저에서 승인 메시지를 수락하라는 메시지가 표시됩니다. 수락하기 전에 Campaign Manager 360에 액세스할 수 있는 Google 계정으로 로그인했는지 확인하세요. 애플리케이션은 현재 로그인되어 있는 계정을 대신하여 데이터에 액세스할 수 있는 권한을 부여받습니다.

   // Create a Google_Client instance.
   //
   // Note: application name should be replaced with a value that identifies
   // your application. Suggested format is "MyCompany-ProductName".
   $client = new Google_Client();
   $client->setAccessType('offline');
   $client->setApplicationName('PHP installed app sample');
   $client->setRedirectUri(self::OAUTH_REDIRECT_URI);
   $client->setScopes(self::$OAUTH_SCOPES);
   
   // Load the client secrets file.
   $client->setAuthConfig($pathToJsonFile);
   
   // Try to load cached credentials from the token store. Using a token store
   // allows auth credentials to be cached, so they survive multiple runs of
   // the application. This avoids prompting the user for authorization every
   // time the access token expires, by remembering the refresh token.
   if (file_exists($tokenStore) && filesize($tokenStore) > 0) {
       $client->setAccessToken(file_get_contents($tokenStore));
   } else {
       // If no cached credentials were found, authorize and persist
       // credentials to the token store.
       print 'Open this URL in your browser and authorize the application.';
       printf("\n\n%s\n\n", $client->createAuthUrl());
       print 'Enter the authorization code: ';
       $code = trim(fgets(STDIN));
       $client->authenticate($code);
   
       file_put_contents($tokenStore, json_encode($client->getAccessToken()));
   }

2. 승인된 Dfareporting 클라이언트를 만듭니다.

   // Create a Dfareporting service object.
   $service = new Google_Service_Dfareporting($client);

3. 작업 실행

   // Retrieve and print all user profiles for the current authorized user.
   $result = $service->userProfiles->listUserProfiles();
   foreach ($result['items'] as $userProfile) {
       printf(
           "User profile \"%s\" (ID: %d) found for account %d.\n",
           $userProfile->getUserName(),
           $userProfile->getProfileId(),
           $userProfile->getAccountId()
       );
   }

Python

1. 클라이언트 보안 비밀번호 파일을 로드하고 승인 사용자 인증 정보를 생성합니다.

   이 단계를 처음 수행하면 브라우저에서 승인 메시지를 수락하라는 메시지가 표시됩니다. 수락하기 전에 Campaign Manager 360에 액세스할 수 있는 Google 계정으로 로그인했는지 확인하세요. 애플리케이션은 현재 로그인되어 있는 계정을 대신하여 데이터에 액세스할 수 있는 권한을 부여받습니다.

   # Set up a Flow object to be used if we need to authenticate.
   flow = client.flow_from_clientsecrets(
       path_to_client_secrets_file, scope=OAUTH_SCOPES)
   
   # Check whether credentials exist in the credential store. Using a credential
   # store allows auth credentials to be cached, so they survive multiple runs
   # of the application. This avoids prompting the user for authorization every
   # time the access token expires, by remembering the refresh token.
   storage = Storage(CREDENTIAL_STORE_FILE)
   credentials = storage.get()
   
   # If no credentials were found, go through the authorization process and
   # persist credentials to the credential store.
   if credentials is None or credentials.invalid:
     credentials = tools.run_flow(flow, storage,
                                  tools.argparser.parse_known_args()[0])
   
   # Use the credentials to authorize an httplib2.Http instance.
   http = credentials.authorize(httplib2.Http())

2. 승인된 Dfareporting 클라이언트를 만듭니다.

   # Construct a service object via the discovery service.
   service = discovery.build('dfareporting', 'v4', http=http)

3. 작업 실행

   # Construct the request.
   request = service.userProfiles().list()
   
   # Execute request and print response.
   response = request.execute()
   
   for profile in response['items']:
     print('Found user profile with ID %s and user name "%s".' %
           (profile['profileId'], profile['userName']))

Ruby

1. 클라이언트 보안 비밀번호 파일을 로드하고 승인 사용자 인증 정보를 생성합니다.

   이 단계를 처음 수행하면 브라우저에서 승인 메시지를 수락하라는 메시지가 표시됩니다. 수락하기 전에 Campaign Manager 360에 액세스할 수 있는 Google 계정으로 로그인했는지 확인하세요. 애플리케이션은 현재 로그인되어 있는 계정을 대신하여 데이터에 액세스할 수 있는 권한을 부여받습니다.

   # Load client ID from the specified file.
   client_id = Google::Auth::ClientId.from_file(path_to_json_file)
   
   # Set up the user authorizer.
   #
   # Note: providing a token store allows auth credentials to be cached, so they
   # survive multiple runs of the application. This avoids prompting the user for
   # authorization every time the access token expires, by remembering the
   # refresh token.
   authorizer = Google::Auth::UserAuthorizer.new(
     client_id, [API_NAMESPACE::AUTH_DFAREPORTING], token_store
   )
   
   # Authorize and persist credentials to the data store.
   #
   # Note: the 'user' value below is used to identify a specific set of
   # credentials in the token store. You may provide different values here to
   # persist credentials for multiple users to the same token store.
   authorization = authorizer.get_credentials('user')
   if authorization.nil?
     puts format(
       "Open this URL in your browser and authorize the application.\n\n%s" \
       "\n\nEnter the authorization code:",
       authorizer.get_authorization_url(base_url: OAUTH_REDIRECT_URI)
     )
     code = STDIN.gets.chomp
     authorization = authorizer.get_and_store_credentials_from_code(
       base_url: OAUTH_REDIRECT_URI, code: code, user_id: 'user'
     )
   end

2. 승인된 Dfareporting 클라이언트를 만듭니다.

   # Create a Dfareporting service object.
   #
   # Note: application name should be replaced with a value that identifies
   # your application. Suggested format is "MyCompany-ProductName".
   service = API_NAMESPACE::DfareportingService.new
   service.authorization = authorization
   service.client_options.application_name = 'Ruby installed app sample'
   service.client_options.application_version = '1.0.0'

3. 작업 실행

   // Retrieve and print all user profiles for the current authorized user.
   UserProfileList profiles = service.UserProfiles.List().Execute();
   
   foreach (UserProfile profile in profiles.Items) {
     Console.WriteLine("Found user profile with ID {0} and name \"{1}\".",
         profile.ProfileId, profile.UserName);
   }