टारगेटिंग सेट करें

टारगेटिंग के विकल्प, असाइन किए गए टारगेटिंग विकल्प, और लाइन आइटम सेवाओं का इस्तेमाल सेट करने के लिए किया जाता है Display &में लाइन आइटम टारगेटिंग Video 360 API. इस पेज पर, उदाहरण के तौर पर दी गई जानकारी और कुछ उदाहरण दिए गए हैं उपलब्ध टारगेटिंग विकल्प कैसे खोजें, इसके लिए टारगेटिंग विकल्प और असाइन किए गए आइटम को सूची में जोड़ने और उनमें बदलाव करने के लिए, लाइन आइटम पर एक साथ कार्रवाइयां करें टारगेटिंग विकल्प.

उपलब्ध टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) विकल्प खोजना

टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) के विकल्प या तो उपयोगकर्ता के तय किए गए वैरिएबल का इस्तेमाल करते हैं, जो पहले से मौजूद ऐसे वैरिएबल का इस्तेमाल करते हैं जिन्हें टारगेट किया जा सकता है इकाइयों, या पहले से मौजूद विकल्पों का इस्तेमाल करें. पहले से मौजूद विकल्पों की पहचान, enum वैल्यू या टारगेटिंग विकल्प का इस्तेमाल करके की जाती है आईडी, जो टारगेटिंग के टाइप के आधार पर तय होता है. टारगेट करने लायक इकाइयों की पहचान करने के लिए, इनका इस्तेमाल किया जाता है इकाई आईडी. टारगेटिंग विकल्प आईडी और इकाई आईडी ढूंढने के लिए, इनका इस्तेमाल किया जा सकता है: डिसप्ले और Video 360 API.

सेट ईनम मानों का इस्तेमाल करें

निम्न लक्ष्यीकरण प्रकारों के लिए लक्ष्यीकरण विकल्प इसका उपयोग करके असाइन किए जाते हैं खास ईनम टाइप:

TargetingType Enum
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 की जगह इस उपनाम मान का इस्तेमाल करें, जब असाइन किए गए टारगेटिंग विकल्पों को वापस पाना या मिटाना.

लक्ष्यीकरण विकल्प आईडी फिर से पाएं

पहले से मौजूद विकल्पों का इस्तेमाल करने वाले टारगेटिंग टाइप, संबंधित विकल्पों का इस्तेमाल करके असाइन किए जाते हैं टारगेटिंग विकल्प आईडी.

उदाहरण के लिए, स्क्रीन पर पोज़िशन की संख्या सीमित होती है. को लक्ष्यीकरण प्रकार TARGETING_TYPE_ON_SCREEN_POSITION का उपयोग करके लक्षित किया जा सकता है. हर इनमें से हर क्रम में, टारगेटिंग के विकल्प का आईडी हो सकता है.

इन टारगेटिंग विकल्प आईडी को टारगेटिंग के विकल्प से जुड़ी सेवा. इसके आधार पर टारगेटिंग टाइप के हिसाब से, डेटा को वापस लाया जाता है. इसके लिए, इन दो में से किसी एक तरीके का इस्तेमाल किया जाता है:

  • व्यक्तिगत तौर पर जानकारी फिर से हासिल करना या पूरी जानकारी वाली सूची: ज़्यादातर टारगेटिंग, get और list तरीकों का इस्तेमाल करके पूरे किए जा सकते हैं. इसकी जानकारी पाने के लिए, targetingTypes.targetingOptions.get का इस्तेमाल करें टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) टाइप और टारगेटिंग विकल्प आईडी से पहचाना गया टारगेटिंग विकल्प. इस्तेमाल की जाने वाली चीज़ें सभी उपलब्ध आइटम को दिखाने के लिए 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
);

टारगेट की जा सकने वाली इकाइयों की सूची बनाएं

टारगेट की जा सकने वाली किसी मौजूदा इकाई का इस्तेमाल करके, किसी लाइन आइटम को टारगेट करने के लिए आपके पास आईडी डालें. टारगेट की जा सकने वाली इकाइयां, जैसे कि चैनल, मिलती-जुलती ऑडियंस, और इन्वेंट्री सोर्स ग्रुप, इसके ज़रिए फिर से हासिल किए जा सकते हैं Google Display &Video 360 के ज़रिए Video 360 API.

हर सेवा के अपने get और list तरीके होते हैं. get तरीके का इस्तेमाल करके, यह पुष्टि करें कि विज्ञापन देने वाले किसी व्यक्ति या कंपनी के तहत कोई इकाई उपलब्ध है. list का इस्तेमाल करना उस संसाधन प्रकार की सभी इकाइयों को खोजने का तरीका है जो दिया गया है और इसलिए उसका उपयोग लाइन आइटम चुनें.

टारगेट की जा सकने वाली इकाइयों के सबसेट को भी एपीआई की मदद से मैनेज किया जा सकता है. यह है create और patch तरीकों का इस्तेमाल करके इन्हें लागू किया जाएगा. साथ ही, इकाइयों में मौजूद अलग-अलग वैल्यू के लिए सेवाएं भी दी जाएंगी, जैसे कि इन्वेंट्री सोर्स, नेगेटिव कीवर्ड, और जगहें.

लोकप्रिय जगह को टारगेट करने के विकल्प के आईडी बनाएं

TARGETING_TYPE_POI के तहत, नाम वाली लोकप्रिय जगहों को टारगेट करने के विकल्प targetingTypes.targetingOptions.search का इस्तेमाल करके वापस लाया गया. तय सीमा में इसके अलावा, आपके पास अपनी पसंद के हिसाब से TARGETING_TYPE_POI टारगेटिंग विकल्प आईडी बनाने का विकल्प भी है लक्षित अक्षांश-देशांतर निर्देशांक.

लोकप्रिय जगह को टारगेट करने के विकल्प का आईडी बनाने के लिए, यह तरीका अपनाएं:

  1. अक्षांश-देशांतर निर्देशांक फिर से पाएं (उदाहरण: "40.7414691, -74.003387")
  2. दशमलव स्थान के छठे स्थान तक पूर्णांकित निर्देशांक मान (उदाहरण: "40.741469, -74.003387")
  3. निर्देशांक मानों से दशमलव स्थान निकाल दें (उदाहरण: "40741469, -74003387")
  4. सेमीकोलन से अलग की गई एक स्ट्रिंग बनाने के लिए, दोनों वैल्यू को जोड़ें (उदाहरण: "40741469;-74003387")

इससे मिली स्ट्रिंग का इस्तेमाल targetingOptionId की तरह तब किया जा सकता है, जब TARGETING_TYPE_POI को टारगेट करने का विकल्प असाइन किया गया.

बनाए जाने के बाद, इसके 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']
);

गड़बड़ियां

टारगेटिंग कॉन्फ़िगरेशन से जुड़ी गड़बड़ियां

इसके बारे में कई जटिल नियम हैं Display &Video 360 में, टारगेटिंग वीडियो 360. इन्हें लागू किया जाता है Display & टारगेट करने का विकल्प बनाने के बाद मिली गड़बड़ियों के ज़रिए Video 360 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

कॉन करंसी की गड़बड़ियां

इसके ज़रिए किसी एक लाइन आइटम की सेटिंग या टारगेटिंग को अपडेट करने की कोशिश करना एक साथ कई अनुरोध करने से गड़बड़ी हो सकती है.

अगर आपको किसी एक टारगेटिंग के लिए, असाइन किए गए कई टारगेटिंग विकल्पों को जोड़ना या हटाना है लाइन आइटम को देखना है, तो आपको एक एक साथ कई बदलाव करने का अनुरोध. अगर आप किसी लाइन आइटम के सेटिंग और टारगेटिंग को देखते हुए, advertisers.lineItems.patch अनुरोध और प्रासंगिक लक्ष्यीकरण का लगातार अनुरोध करके, यह सुनिश्चित करने के लिए कि अनुरोध को तब तक नहीं भेजा जाता, जब तक कि पहले उपयोगकर्ता ने जवाब नहीं दिया.

बल्क और रिसॉर्स के हिसाब से टारगेटिंग ऑपरेशन

असाइन किए गए डेटा को मैनेज करने के लिए, बल्क और संसाधनों के हिसाब से टारगेट करने के तरीकों का इस्तेमाल किया जा सकता है टारगेटिंग के अलग-अलग टाइप के हिसाब से टारगेटिंग के विकल्प:

  • सभी टारगेटिंग विकल्पों को फिर से पाने या उनमें बदलाव करने के लिए बल्क टारगेट करने के तरीकों का इस्तेमाल करें इसमें कई तरह की टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) शामिल हैं. Google Analytics 4 प्रॉपर्टी पर जाकर, इसका इस्तेमाल करके, कई लाइन आइटम के लिए पूरे टारगेटिंग कॉन्फ़िगरेशन advertisers.lineItems.bulkListAssignedTargetingOptions या इसका उपयोग करके अनेक लाइन आइटम में लक्ष्यीकरण को एक समान अपडेट कर सकते हैं advertisers.lineItems.bulkEditAssignedTargetingOptions. ये सिर्फ़ advertisers.lineItems में उपलब्ध हैं सेवा.
  • टारगेटिंग के विकल्पों को फिर से पाने या उनमें बदलाव करने के लिए, संसाधन के हिसाब से टारगेट करने के तरीकों का इस्तेमाल करना जिसमें एक ही संसाधन के तहत कई तरह के टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) के लिए इस्तेमाल किया जाता है. ये उपलब्ध हैं 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 यह कई तरह की टारगेटिंग के कई टारगेटिंग विकल्पों को जोड़ने और हटाने का तरीका बताता है एक या ज़्यादा लाइन आइटम से एक साथ टाइप करें.

यह तरीका, DeleteAssignedTargetingOptionsRequests और इसकी सूची CreateAssignedTargetingOptionsRequests. सिर्फ़ एक अनुरोध ऑब्जेक्ट, असाइन की गई कई टारगेटिंग को मिटाने या बनाने को दिखा सकता है एक ही तरह के टारगेटिंग टाइप के विकल्प.

यदि किसी असाइन किए गए लक्ष्यीकरण विकल्प को हटाने या बनाने का प्रयास करने के कारण गड़बड़ी है, तो उस लाइन आइटम के लिए बल्क कार्रवाई छोड़ दी गई है. कॉन्टेंट बनाने अनुरोध, अपडेट की गई लाइन की सूची दिखाता है आइटम और उन लाइन आइटम की सूचियां जिन्हें अपलोड नहीं किया जा सका अपडेट करें और काम की जानकारी पाएं गड़बड़ियां.

यहां एक या एक से ज़्यादा टारगेटिंग विकल्पों में, एक साथ कई बदलाव करने का तरीका बताया गया है वे लाइन आइटम जिनमें टारगेटिंग को मिटाने और टारगेट करने के लिए, असाइन किए गए टारगेटिंग विकल्पों की सूची दी गई है बनाने के विकल्प:

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');
}