このページは Cloud Translation API によって翻訳されました。

ターゲティングを設定

Display & Video 360 API で広告申込情報のターゲティングを設定するには、ターゲティングオプション、割り当て済みのターゲティングオプション、広告申込情報の各サービスを組み合わせて使用します。このページでは、利用可能なターゲティングオプションを見つける方法、広告申込情報にターゲティングオプションを割り当てる方法、広告申込情報に対して一括操作を実行して、割り当てられたターゲティングオプションを一覧表示および編集する方法について説明します。

利用可能なターゲティングオプションを確認する

ターゲティングオプションでは、ユーザー指定の変数、既存のターゲット設定可能なエンティティ、既存のオプションのいずれかを使用して、目的のターゲットオーディエンスを定義します。既存オプションは、ターゲティングタイプに応じて列挙値またはターゲティングオプション ID を使用して識別されます。ターゲット設定可能なエンティティは、エンティティ ID で識別されます。ターゲティングオプション ID とエンティティ ID は、Display & Video 360 API を使用して確認できます。

列挙値の設定を使用する

次のターゲティングタイプのターゲティングオプションは、特定の列挙型を使用して割り当てられます。

`TargetingType`	列挙型
`TARGETING_TYPE_AGE_RANGE`	`AgeRange`
`TARGETING_TYPE_CONTENT_INSTREAM_POSITION`	`ContentInstreamPosition`
`TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`	`ContentOutstreamPosition`
`TARGETING_TYPE_DEVICE_TYPE`	`DeviceType`
`TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`	`ContentRatingTier`
`TARGETING_TYPE_ENVIRONMENT`	`Environment`
`TARGETING_TYPE_EXCHANGE`	`Exchange`
`TARGETING_TYPE_GENDER`	`Gender`
`TARGETING_TYPE_HOUSEHOLD_INCOME`	`HouseholdIncome`
`TARGETING_TYPE_NATIVE_CONTENT_POSITION`	`NativeContentPosition`
`TARGETING_TYPE_OMID`	`Omid`
`TARGETING_TYPE_PARENTAL_STATUS`	`ParentalStatus`
`TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`	`SensitiveCategory`
`TARGETING_TYPE_VIDEO_PLAYER_SIZE`	`VideoPlayerSize`
`TARGETING_TYPE_VIEWABILITY`	`Viewability`

該当する列挙値の文字列バージョンは、これらのターゲティングタイプの既存の AssignedTargetingOption リソースを識別するために使用でき、assignedTargetingOptionIdAlias フィールドで使用できます。このエイリアス値は、割り当てられたターゲティングオプションを取得または削除する際に、assignedTargetingOptionId の代わりに使用できます。

ターゲティングオプション ID を取得する

既存のオプションを使用するターゲティングタイプは、対応するターゲティングオプション ID を使用して割り当てられます。

たとえば、ターゲティングタイプ TARGETING_TYPE_ON_SCREEN_POSITION を使用してターゲットに設定できる画面上の位置の数が限られています。各位置には、対応するターゲティングオプション ID があります。

これらのターゲティングオプション ID は、ターゲティングオプションサービスで取得できます。ターゲティングタイプに応じて、次のいずれかの方法で取得できます。

個別取得または網羅リスト: 多くのターゲティングタイプのオプションを取得するには、get メソッドと list メソッドを使用します。targetingTypes.targetingOptions.get を使用して、ターゲティングタイプとターゲティングオプション ID で識別されるターゲティングオプションの詳細を取得します。特定のターゲティングタイプで使用可能なすべてのターゲティングオプションを一覧表示するには、targetingTypes.targetingOptions.list を使用します。
検索: 位置情報ベースのターゲティングタイプ（TARGETING_TYPE_GEO_REGION、TARGETING_TYPE_POI、TARGETING_TYPE_BUSINESS_CHAIN）のオプションは、search メソッドを使用して取得する必要があります。targetingTypes.targetingOptions.search を使用して、指定したクエリ文字列に一致する特定のタイプのターゲティングオプションを取得します。

ターゲティングタイプ TARGETING_TYPE_BROWSER の可能なターゲティングオプションのリストを取得する方法の例を次に示します。

Java

// Configure the list request.
TargetingOptions.List request =
   service
       .targetingTypes()
       .targetingOptions()
       .list("TARGETING_TYPE_BROWSER")
       .setAdvertiserId(advertiser-id);

// Create the response and nextPageToken variables.
ListTargetingOptionsResponse response;
String nextPageToken = null;

do {
 // Create and execute the list request.
 response = request.setPageToken(nextPageToken).execute();

 // Check if the response is empty.
 if (response.isEmpty()) {
   System.out.print("List request returned no Targeting Options");
   break;
 }

 // Iterate over retrieved targeting options.
 for (TargetingOption option : response.getTargetingOptions()) {
   System.out.printf(
       "Targeting Option ID: %s, Browser Display Name: '%s'\n",
       option.getTargetingOptionId(), option.getBrowserDetails().getDisplayName());
 }

 // Update the next page token.
 nextPageToken = response.getNextPageToken();
} while (!Strings.isNullOrEmpty(nextPageToken));

Python

# Create the page token variable.
next_page_token = ""

while True:
  # Request the targeting options list.
  response = service.targetingTypes() \
    .targetingOptions().list(
      advertiserId=advertiser-id,
      targetingType="TARGETING_TYPE_BROWSER",
      pageToken=next_page_token
  ).execute()

  # Check if response is empty.
  if not response:
    print("List request returned no Targeting Options")
    break

  # Iterate over retrieved targeting options.
  for option in response['targetingOptions']:
    print("Targeting Option ID: %s, Browser Display Name: %s"
          % (option['targetingOptionId'], option['browserDetails']['displayName']))

  # Break out of loop if there is no next page.
  if 'nextPageToken' not in response:
    break

  # Update the next page token.
  next_page_token = response['nextPageToken']

PHP

// Create the page token variable.
$nextPageToken = null;

do {
    // Build the query parameters object for the request.
    $optParams = array(
        'advertiserId' => advertiser-id,
        'pageToken' => $nextPageToken
    );

    // Call the API, getting the browser targeting options for the
    // identified advertiser.
    $response = $this
        ->service
        ->targetingTypes_targetingOptions
        ->listTargetingTypesTargetingOptions(
            'TARGETING_TYPE_BROWSER',
            $optParams
        );

    // Print the resulting targeting options.
    if (!empty($response->getTargetingOptions())) {
        foreach ($response->getTargetingOptions() as $option) {
            printf(
                'Targeting Option ID: %s, Browser Display Name: %s\n',
                $option['targetingOptionId'],
                $option['browserDetails']['displayName']
            );
        }
    } else {
        print('No targeting options returned\n');
    }

    // Update the next page token.
    $nextPageToken = $response->getNextPageToken();
} while (
    !empty($response->getTargetingOptions())
    && $nextPageToken
);

ターゲット設定可能なエンティティのリスト

ターゲティング可能な既存のエンティティを使用して広告申込情報をターゲティングするには、そのエンティティの ID が必要です。ターゲット設定可能なエンティティ（チャネル、統合オーディエンス、広告枠ソースグループなど）は、Display & Video 360 API のそれぞれのサービスを通じて取得できます。

各サービスには、独自の get メソッドと list メソッドがあります。get メソッドを使用して、特定の広告主からエンティティが使用可能であることを確認します。list メソッドを使用して、特定の広告主が利用できる（つまり、その広告主の広告申込情報にターゲティングを割り当てる際に使用できる）リソースタイプのすべてのエンティティを検出します。

ターゲット設定可能なエンティティのサブセットを API で管理することもできます。これを行うには、対応するサービスの create メソッドと patch メソッドのほか、エンティティにリストされている個々の値（広告枠ソース、除外キーワード、ロケーションなど）に対応するサービスを使用します。

スポットターゲティングオプション ID を作成する

TARGETING_TYPE_POI にある名前付きスポットターゲティングオプションは、targetingTypes.targetingOptions.search を使用して取得できます。また、独自の TARGETING_TYPE_POI ターゲティングオプション ID を作成して、特定の緯度と経度の座標をターゲットに設定することもできます。

スポットターゲティングオプション ID を作成する手順は次のとおりです。

緯度と経度の座標を取得します（例: 「40.7414691, -74.003387」）
座標値を小数点以下 6 桁に丸める（例: "40.741469, -74.003387"）
座標値から小数点以下の桁を削除します（例: "40741469, -74003387"）。
2 つの値を連結して、セミコロンで区切った 1 つの文字列にします（例: "40741469;-74003387"）。

結果の文字列は、TARGETING_TYPE_POI が割り当てられたターゲティングオプションを作成するときに targetingOptionId として使用できます。

作成時に、割り当てられたターゲティングオプションリソースの targetingOptionId フィールドと assignedTargetingOptionId フィールドが更新され、セミコロンと英数字のハッシュが追加されます。

ターゲティングオプションを割り当てる

広告申込情報に割り当てられたターゲティングは、割り当てられたターゲティングオプションとして表されます。これらのエンティティは、割り当てられたターゲティングオプションサービスを使用して管理できます。割り当てられたターゲティングオプションを作成すると、そのターゲティングの詳細情報が親広告申込情報に適用されます。割り当て済みの既存のターゲティングオプションを削除すると、そのターゲティングが削除されます。

advertisers.lineItems.targetingTypes.assignedTargetingOptions.create を使用して、割り当てられたターゲティングオプションを作成します。目的のターゲティングタイプに対応するターゲティングオプションリソースの details フィールドに、ターゲティングパラメータを指定します。

ターゲティングタイプ TARGETING_TYPE_BROWSER の割り当てターゲティングオプションを作成する例を次に示します。

Java

// Create an AssignedTargetingOption object of the
// browser targeting type.
AssignedTargetingOption assignedTargetingOption =
   new AssignedTargetingOption()
       .setBrowserDetails(
           new BrowserAssignedTargetingOptionDetails()
               .setTargetingOptionId(targeting-option-id));

// Configure the create request.
AssignedTargetingOptions.Create request =
   service
       .advertisers()
       .lineItems()
       .targetingTypes()
       .assignedTargetingOptions()
       .create(
           advertiser-id,
           line-item-id,
           "TARGETING_TYPE_BROWSER",
           assignedTargetingOption);

// Send the request.
AssignedTargetingOption response = request.execute();

// Display the new assigned targeting option.
System.out.printf("AssignedTargetingOption %s was created.",
   response.getName());

Python

# Create a assigned targeting option object.
assigned_targeting_option_obj = {
    'browserDetails': {
        'targetingOptionId': targeting-option-id
    }
}

# Create the assigned targeting option.
assigned_targeting_option = service.advertisers().lineItems()\
  .targetingTypes().assignedTargetingOptions().create(
    advertiserId=advertiser-id,
    lineItemId=line-item-id,
    targetingType="TARGETING_TYPE_BROWSER",
    body=assigned_targeting_option_obj
).execute()

# Display the new assigned targeting option.
print("Assigned Targeting Option %s was created."
      % assigned_targeting_option["name"])

PHP

// Create a assigned targeting option object.
$assignedTargetingOption =
    new Google_Service_DisplayVideo_AssignedTargetingOption();

// Create and set browser details.
$details =
    new Google_Service_DisplayVideo_BrowserAssignedTargetingOptionDetails();
$details->setTargetingOptionId(targeting-option-id);
$assignedTargetingOption->setBrowserDetails($details);

// Call the API, creating the browser assigned targeting option for the
// given line item.
$result = $this
    ->service
    ->advertisers_lineItems_targetingTypes_assignedTargetingOptions
    ->create(
        advertiser-id,
        line-item-id,
        'TARGETING_TYPE_BROWSER',
        $assignedTargetingOption
    );

printf(
    'Assigned Targeting Option %s was created.\n',
    $result['name']
);

エラー

ターゲティング設定エラー

ディスプレイ &ビデオ 360 のターゲティングについては、多くの複雑なルールがあります。これは、割り当てたターゲティングオプションの作成時に返されるエラーを通じて、Display & Video 360 API で適用されます。API から返されるエラーで、違反が特定されます。

エラーの主な原因は、広告申込情報に割り当てられている既存のターゲティングです。広告申込情報に割り当てられている特定のターゲティングタイプのすべてのターゲティングオプションを取得するには advertisers.lineItems.targetingTypes.assignedTargetingOptions.list を使用します。制限がある場合に目的のターゲティングが可能かどうかを評価してから、不要なターゲティングを削除する場合は advertisers.lineItems.targetingTypes.assignedTargetingOptions.delete を使用して該当するターゲティングオプションの作成を再度行います。

YouTube とパートナーのターゲティングエラー

YouTube とパートナーのキャンペーン専用のターゲティングは、Display & Video 360 API では更新できないため、更新しようとするとエラーが発生します。

YouTube とパートナーのターゲティングは、YouTube とパートナーの広告申込情報と広告グループに直接割り当てられたすべてのターゲティングと、以下のターゲティングタイプのターゲティングで構成されます。

TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO

同時実行エラー

複数の同時リクエストを使用して 1 つの広告申込情報の設定やターゲティングを更新しようとすると、エラーが発生します。

1 つの広告申込情報で割り当てられた複数のターゲティングオプションを同時に追加または削除する必要がある場合は、一括編集リクエストを使用してください。広告申込情報の設定とターゲティングを更新する場合は、advertisers.lineItems.patch リクエストと関連するターゲティングリクエストを連続して実行し、最初のリクエストからレスポンスが返されるまで 2 番目のリクエストが送信されないようにします。

一括およびリソース全体のターゲティング操作

一括ターゲティング方法またはリソースワイドターゲティング方法を使用して、ターゲティングタイプごとに割り当てられたターゲティングオプションを管理できます。

一括ターゲティング方法を使用すると、複数のターゲティングタイプや複数のリソースに含まれるターゲティングオプションを取得または編集できます。advertisers.lineItems.bulkListAssignedTargetingOptions を使って複数の広告申込情報のターゲティング設定全体を取得することも、advertisers.lineItems.bulkEditAssignedTargetingOptions を使って複数の広告申込情報のターゲティングをまったく更新することも可能です。これらは advertisers.lineItems サービスでのみ使用できます。
リソース全体のターゲティング方法を使用すると、1 つのリソースに含まれる複数のターゲティングタイプについて、ターゲティングオプションを取得または編集できます。これらは、partners、advertisers、advertisers.campaigns、advertisers.insertionOrders サービスで使用可能です。名前は listAssignedTargetingOptions または editAssignedTargetingOptions です。

広告申込情報の現在のターゲティングを全体的に把握したい場合、既定のターゲティング設定を広告申込情報に適用する場合、広告申込情報のターゲティングに複数の変更を同時に加える場合は、以下のターゲティング方法を使用することをおすすめします。

リストターゲティングの一括処理

advertisers.lineItems.bulkListAssignedTargetingOptions を使用すると、さまざまなターゲティングタイプについて、広告申込情報に割り当てられたすべてのターゲティングを確認できます。これは他の list メソッドと同様に動作します。filter クエリパラメータを使用すると、TargetingType または Inheritance で結果をフィルタリングできます。

広告申込情報に割り当てて、親パートナーまたは広告主によって継承されたすべてのターゲティングオプションを一覧表示する方法の例を次に示します。

Java

// Configure the bulk list request.
LineItems.BulkListAssignedTargetingOptions request =
    service.advertisers().lineItems()
        .bulkListAssignedTargetingOptions(advertiser-id);

// Set Line Items to retrieve targeting for.
request.setLineItemIds(line-item-ids);

// Set filter to only return inherited assigned targeting options.
request.setFilter(
    "inheritance=\"INHERITED_FROM_ADVERTISER\" OR inheritance=\"INHERITED_FROM_PARTNER\"");

// Create the response and nextPageToken variables.
BulkListAssignedTargetingOptionsResponse response;
String nextPageToken = null;

do {
  // Set page token and execute the list request.
  response = request.setPageToken(nextPageToken).execute();

  // Check if the response is empty.
  if (response.isEmpty()) {
    System.out.print("Bulk list request returned no Assigned Targeting Options");
    break;
  }

  // Iterate over retrieved line item assigned targeting option wrapper objects.
  for (LineItemAssignedTargetingOption lineItemAssignedTargetingOption
      : response.getLineItemAssignedTargetingOptions()) {
    System.out.printf(
        "Assigned Targeting Option %s found\n",
        lineItemAssignedTargetingOption.getAssignedTargetingOption().getName());
  }

  // Update the next page token.
  nextPageToken = response.getNextPageToken();
} while (!Strings.isNullOrEmpty(nextPageToken));

Python

# Create the page token variable.
next_page_token = ""

while True:
  # Execute the list request.
  response = service.advertisers().lineItems() \
    .bulkListAssignedTargetingOptions(
      advertiserId=advertiser-id,
      lineItemIds=line-item-ids,
      filter="inheritance=\"INHERITED_FROM_ADVERTISER\" OR "
             "inheritance=\"INHERITED_FROM_PARTNER\"",
      pageToken=next_page_token
  ).execute()

  # Check if response is empty.
  if not response:
    print("Bulk list request returned no Assigned Targeting Options")
    break

  # Iterate over retrieved assigned targeting options.
  for lineItemAssignedTargetingOption in response['lineItemAssignedTargetingOptions']:
    print("Assigned Targeting Option %s found"
          % (lineItemAssignedTargetingOption['assignedTargetingOption']['name']))

  # Break out of loop if there is no next page.
  if 'nextPageToken' not in response:
    break

  # Update the next page token.
  next_page_token = response['nextPageToken']

PHP

// Create the page token variable.
$nextPageToken = null;

do {
    // Build the query parameters object for the request.
    $optParams = array(
        'lineItemIds' => line-item-ids,
        'filter' => "inheritance=\"INHERITED_FROM_ADVERTISER\" OR "
            . "inheritance=\"INHERITED_FROM_PARTNER\"",
        'pageToken' => $nextPageToken
    );

    // Call the API, getting all the assigned targeting options for the
    // identified line item.
    $response = $service
        ->advertisers_lineItems
        ->bulkListAssignedTargetingOptions(
            advertiser-id,
            $optParams
    );

    // Print the returned assigned targeting options.
    if (!empty($response->getLineItemAssignedTargetingOptions())) {
        foreach ($response->getLineItemAssignedTargetingOptions() as $option) {
            printf('Assigned Targeting Option %s found\n', $option->getAssignedTargetingOption()['name']);
        }
    } else {
        print('No targeting options returned\n');
    }

    // Update the next page token.
    $nextPageToken = $response->getNextPageToken();
} while (
    !empty($response->getLineItemAssignedTargetingOptions())
    && $nextPageToken);

ターゲティングを一括編集する

advertisers.lineItems.bulkEditAssignedTargetingOptions を使用すると、さまざまなターゲティングタイプの複数のターゲティングオプションを 1 つ以上の広告申込情報から同時に追加または削除できます。

このメソッドは、DeleteAssignedTargetingOptionsRequests のリストと CreateAssignedTargetingOptionsRequests のリストを受け取ります。1 つのリクエストオブジェクトで、同じターゲティングタイプに割り当てられた複数のターゲティングオプションの削除または作成を指定できます。

割り当て済みのターゲティングオプションの削除や作成を行おうとすると、広告申込情報でエラーとなった場合、その広告申込情報に対する一括操作は破棄されます。このリクエストでは、正常に更新された広告申込情報のリストのほか、更新に失敗した広告申込情報および関連するエラーのリストが返されます。

以下に、1 つ以上の広告申込情報に割り当てられたターゲティングオプションを、削除するターゲティングオプションと作成するターゲティングオプションのリストを指定して一括編集する方法の例を示します。

Java

// Create a bulk edit request.
BulkEditAssignedTargetingOptionsRequest requestContent =
    new BulkEditAssignedTargetingOptionsRequest();

// Set line item IDs in edit request.
requestContent.setLineItemIds(line-item-ids);

// Build delete request list.
ArrayList<DeleteAssignedTargetingOptionsRequest> deleteRequests =
    new ArrayList<DeleteAssignedTargetingOptionsRequest>();

// Add browser assigned targeting option IDs to delete request list.
deleteRequests.add(new DeleteAssignedTargetingOptionsRequest()
    .setTargetingType("TARGETING_TYPE_BROWSER")
    .setAssignedTargetingOptionIds(delete-browser-assigned-targeting-ids));

// Add device make or model assigned targeting option IDs to delete request list.
deleteRequests.add(new DeleteAssignedTargetingOptionsRequest()
    .setTargetingType("TARGETING_TYPE_DEVICE_MAKE_MODEL")
    .setAssignedTargetingOptionIds(
        delete-device-make-model-assigned-targeting-ids));

// Set delete requests in edit request.
requestContent.setDeleteRequests(deleteRequests);

// Build create request list.
ArrayList<CreateAssignedTargetingOptionsRequest> createRequests =
    new ArrayList<CreateAssignedTargetingOptionsRequest>();

// Create browser assigned targeting option create request.
CreateAssignedTargetingOptionsRequest createBrowserTargetingRequest =
    new CreateAssignedTargetingOptionsRequest();
createBrowserTargetingRequest.setTargetingType("TARGETING_TYPE_BROWSER");

// Create and set list of browser assigned targeting options.
ArrayList<AssignedTargetingOption> createBrowserAssignedTargetingOptions =
    new ArrayList<AssignedTargetingOption>();
for (String targetingOptionId : create-browser-assigned-targeting-ids) {
  createBrowserAssignedTargetingOptions.add(new AssignedTargetingOption()
      .setBrowserDetails(
          new BrowserAssignedTargetingOptionDetails()
              .setTargetingOptionId(targetingOptionId)));
}
createBrowserTargetingRequest
    .setAssignedTargetingOptions(createBrowserAssignedTargetingOptions);

// Add browser assigned targeting options to list of create requests.
createRequests.add(createBrowserTargetingRequest);

// Set create requests in edit request.
requestContent.setCreateRequests(createRequests);

// Configure the bulk edit request.
LineItems.BulkEditAssignedTargetingOptions request =
    service.advertisers().lineItems()
        .bulkEditAssignedTargetingOptions(
            advertiser-id,
            requestContent);

// Execute bulk edit request.
BulkEditAssignedTargetingOptionsResponse response = request.execute();

// Check if any line items updated successfully.
if (response.getUpdatedLineItemIds() == null || response.getUpdatedLineItemIds().isEmpty()) {
  System.out.println("No line items were updated successfully.");
} else {
  System.out.printf(
      "Targeting configurations for the following line item IDs were updated: %s.\n",
      Arrays.toString(response.getUpdatedLineItemIds().toArray()));
}

// Check if any line items failed to update.
if (response.getFailedLineItemIds() == null || response.getFailedLineItemIds().isEmpty()) {
  System.out.println("No line items failed to update.");
} else {
  // Print the line items that failed to update.
  System.out.printf(
      "Targeting configurations for the following line item IDs failed to update: %s.\n",
      Arrays.toString(response.getFailedLineItemIds().toArray()));

  // Print errors thrown for failed updates.
  System.out.println("The failed updates were caused by the following errors:");
  for (Status error : response.getErrors()) {
    System.out.printf("Error Code: %s, Message: %s\n", error.getCode(), error.getMessage());
  }
}

Python

# Build assigned targeting option objects to create.
createBrowserAssignedTargetingOptions = []
for targeting_id in create-browser-assigned-targeting-ids:
  createBrowserAssignedTargetingOptions.append(
      {'browserDetails': {'targetingOptionId': targeting_id}}
  )

# Create a bulk edit request.
bulk_edit_line_item_request = {
    'lineItemIds': line-item-ids,
    'deleteRequests': [
        {
            'targetingType': 'TARGETING_TYPE_BROWSER',
            'assignedTargetingOptionIds':
              delete-browser-assigned-targeting-ids
        },
        {
            'targetingType': 'TARGETING_TYPE_DEVICE_MAKE_MODEL',
            'assignedTargetingOptionIds':
              delete-device-make-model-assigned-targeting-ids
        }
    ],
    'createRequests': [
        {
            'targetingType': 'TARGETING_TYPE_BROWSER',
            'assignedTargetingOptions':
              createBrowserAssignedTargetingOptions
        }
    ]
}

# Edit the line item targeting.
response = service.advertisers().lineItems()\
  .bulkEditAssignedTargetingOptions(
    advertiserId=advertiser-id,
    body=bulk_edit_line_item_request
).execute()

# Print successfully updated line items.
if 'updatedLineItemIds' not in response:
  print("No line items were updated successfully.")
else:
  print("Targeting configurations for the following line item IDs were updated: %s"
        % response['updatedLineItemIds'])

# Print line items that failed to update.
if 'failedLineItemIds' not in response:
  print("No line items failed to update.")
else:
  print("Targeting configurations for the following line item IDs failed to update: %s"
        % response['failedLineItemIds'])
  if 'errors' in response:
    print("The failed updates were caused by the following errors:")
    for error in response["errors"]:
      print("Error code: %s, Message: %s" % (error["code"], error["message"]))

PHP

// Create delete request list.
$deleteRequests = array();

// Create and add browser assigned targeting option IDs to delete request list.
$deleteBrowserTargetingRequest =
    new Google_Service_DisplayVideo_DeleteAssignedTargetingOptionsRequest();
$deleteBrowserTargetingRequest->setTargetingType(
    "TARGETING_TYPE_BROWSER"
);
$deleteBrowserTargetingRequest->setAssignedTargetingOptionIds(
    delete-browser-assigned-targeting-ids
);
$deleteRequests[] = $deleteBrowserTargetingRequest;

// Create and add device assigned targeting option IDs to delete request list.
$deleteDeviceTargetingRequest =
    new Google_Service_DisplayVideo_DeleteAssignedTargetingOptionsRequest();
$deleteDeviceTargetingRequest->setTargetingType(
    "TARGETING_TYPE_DEVICE_MAKE_MODEL"
);
$deleteDeviceTargetingRequest->setAssignedTargetingOptionIds(
    delete-device-make-model-assigned-targeting-ids
);
$deleteRequests[] = $deleteDeviceTargetingRequest;

// Create create request list.
$createRequests = array();

// Create and populate list of browser assigned targetion options to create.
$createBrowserAssignedTargetingOptions = array();
foreach (create-browser-assigned-targeting-ids as $optionId) {
    $option = new Google_Service_DisplayVideo_AssignedTargetingOption();
    $details =
        new Google_Service_DisplayVideo_BrowserAssignedTargetingOptionDetails();
    $details->setTargetingOptionId($optionId);

    $option->setBrowserDetails($details);
    $createBrowserAssignedTargetingOptions[] = $option;
}

// Create and add browser assigned targeting option create request to create
// request list.
$createBrowserTargetingRequest =
    new Google_Service_DisplayVideo_CreateAssignedTargetingOptionsRequest();
$createBrowserTargetingRequest->setTargetingType(
    "TARGETING_TYPE_BROWSER"
);
$createBrowserTargetingRequest->setAssignedTargetingOptions(
    $createBrowserAssignedTargetingOptions
);
$createRequests[] = $createBrowserTargetingRequest;

// Create a bulk edit request and assign create and delete request lists.
$body =
    new Google_Service_DisplayVideo_BulkEditAssignedTargetingOptionsRequest();
$body->setLineItemIds(line-item-ids);
$body->setCreateRequests($createRequests);
$body->setDeleteRequests($deleteRequests);

// Call the API, editing the assigned targeting options for the identified
// line item.
$response = $service
    ->advertisers_lineItems
    ->bulkEditAssignedTargetingOptions(
        advertiser-id,
        $body
    );

// Print successfully updated line items.
if (!empty($response->getUpdatedLineItemIds())) {
    printf('Targeting configurations for the following line item IDs were updated:\n');
    foreach ($response->getUpdatedLineItemIds() as $id) {
        printf('%s\n', $id);
    }
} else {
    print('No line items were updated successfully.\n');
}

// Print line items that failed to update.
if (!empty($response->getFailedLineItemIds())) {
    print('Targeting configurations for the following line item IDs failed to update:\n');
    foreach ($response->getFailedLineItemIds() as $id) {
        printf('%s\n', $id);
    }
    print('The failed updates were caused by the following errors:\n');
    foreach ($response->getErrors() as $error) {
        printf('Error Code: %s, Message: %s\n', $error->getCode(), $error->getMessage());
    }
} else {
    print('No line items failed to update.\n');
}

リソースを作成

YouTube とパートナーの広告申込情報を取得する

ターゲティングを設定

利用可能なターゲティング オプションを確認する

列挙値の設定を使用する

ターゲティング オプション ID を取得する

Java

Python

PHP

ターゲット設定可能なエンティティのリスト

スポット ターゲティング オプション ID を作成する

ターゲティング オプションを割り当てる

Java

Python

PHP

エラー

ターゲティング設定エラー

YouTube とパートナーのターゲティング エラー

同時実行エラー

一括およびリソース全体のターゲティング操作

リスト ターゲティングの一括処理

Java

Python

PHP

ターゲティングを一括編集する

Java

Python

PHP

利用可能なターゲティングオプションを確認する

ターゲティングオプション ID を取得する

スポットターゲティングオプション ID を作成する

ターゲティングオプションを割り当てる

YouTube とパートナーのターゲティングエラー

リストターゲティングの一括処理