Establecer orientación

Los servicios Opciones de segmentación, Opciones de segmentación asignadas y Líneas de pedido se usan en conjunto para configurar la segmentación de línea de pedido en la API de Display & Video 360. En esta página, se describen y proporcionan ejemplos de cómo encontrar opciones de segmentación disponibles, asignar opciones de segmentación a líneas de pedido y ejecutar operaciones masivas en líneas de pedido para enumerar y editar las opciones de segmentación asignadas.

Encontrar las opciones de segmentación disponibles

Las opciones de segmentación usan opciones especificadas por el usuario, entidades de segmentación existentes o bien opciones preexistentes para definir el público objetivo deseado. Las opciones preexistentes se identifican mediante valores de enumeración o los ID de opción de segmentación, según el tipo de segmentación. Las entidades que se pueden orientar se identifican mediante sus ID de entidad. Los IDs de opción de segmentación y los IDs de la entidad se pueden encontrar con la API de Display & Video 360.

Cómo usar valores enum establecidos

Las opciones de segmentación para los siguientes tipos de segmentación se asignan según tipos de enumeración específicos:

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

Se puede usar una versión de cadena del valor enum relevante para identificar los recursos AssignedTargetingOption existentes de estos tipos de segmentación y está disponible en el campo assignedTargetingOptionIdAlias. Puedes usar este valor de alias en lugar de assignedTargetingOptionId cuando recuperas o borras las opciones de segmentación asignadas.

Recuperar los ID de opción de orientación

Los tipos de segmentación que usan opciones preexistentes se asignan usando los IDs de opción de segmentación correspondientes.

Por ejemplo, hay una cantidad limitada de posiciones en pantalla que se pueden segmentar con el tipo de segmentación TARGETING_TYPE_ON_SCREEN_POSITION. Cada una de ellas tiene un ID de opción de segmentación correspondiente.

Estos ID de opción de segmentación se pueden recuperar mediante el servicio de Opciones de segmentación. Según el tipo de segmentación, la recuperación se realiza de una de estas dos maneras:

  • Recuperación individual o lista exhaustiva: La recuperación de opciones para la mayoría de los tipos de segmentación se puede realizar con los métodos get y list. Usa targetingTypes.targetingOptions.get para recuperar los detalles de una opción de segmentación identificada mediante un tipo y un ID de opción de segmentación. Usa targetingTypes.targetingOptions.list para enumerar todas las opciones de segmentación disponibles de un tipo determinado.
  • Búsqueda: Las opciones para un tipo de segmentación basada en la ubicación (TARGETING_TYPE_GEO_REGION, TARGETING_TYPE_POI y TARGETING_TYPE_BUSINESS_CHAIN) se deben recuperar mediante el método search. Usa targetingTypes.targetingOptions.search para recuperar las opciones de segmentación de un tipo determinado que coincidan con las cadenas de consulta determinadas.

A continuación, se incluye un ejemplo de cómo recuperar una lista de posibles opciones de segmentación para el tipo de segmentación 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
);

Enumerar entidades a las que se puede orientar

Para orientar una línea de pedido con una entidad que se puede orientar existente, necesitas el ID de esa entidad. Las entidades que se pueden segmentar, como los canales, los públicos combinados y los grupos de fuentes de inventario, se pueden recuperar a través de sus propios servicios en la API de Display & Video 360.

Cada servicio tiene sus propios métodos get y list. Usa el método get para confirmar que una entidad está disponible para un anunciante determinado. Usa el método list a fin de descubrir todas las entidades de ese tipo de recurso que están disponibles para un anunciante determinado y, por lo tanto, que se pueden usar en la asignación de segmentación a una línea de pedido en ese anunciante.

Un subconjunto de entidades que se pueden orientar también se puede administrar a través de la API. Esto se hace a través de los métodos create y patch en el servicio correspondiente, además de los servicios para los valores individuales enumerados en las entidades, como fuentes de inventario, palabras clave negativas y ubicaciones.

Cómo crear IDs de opciones de segmentación de lugares de interés

Las opciones de segmentación de lugares de interés designados, en TARGETING_TYPE_POI, se pueden recuperar mediante targetingTypes.targetingOptions.search. Además, puedes crear IDs de opciones de segmentación de TARGETING_TYPE_POI personalizados para segmentar coordenadas específicas de latitud y longitud.

Sigue estos pasos para crear un ID de opción de orientación de lugares de interés:

  1. Cómo obtener las coordenadas de latitud y longitud (p. ej.: "40.7414691, -74.003387")
  2. Redondear los valores de coordenadas al sexto decimal (p. ej.: “40.741469, -74.003387”)
  3. Quita los decimales de los valores de coordenadas (p. ej.: “40741469, -74003387”).
  4. Concatena los dos valores para crear una sola string separada por punto y coma (p. ej.: “40741469;-74003387”)

La cadena resultante se puede usar como targetingOptionId cuando se crea una opción de segmentación asignada TARGETING_TYPE_POI.

Una vez creado, se actualizarán los campos targetingOptionId y assignedTargetingOptionId del recurso de opción de segmentación asignado y se agregarán un punto y coma y un hash alfanumérico.

Asignar una opción de segmentación

La segmentación asignada a una línea de pedido se representa como una Opción de segmentación asignada. Puedes administrar estas entidades con el servicio de Opciones de segmentación asignada. Cuando se crea una opción de segmentación asignada, se aplican esos detalles de segmentación a la línea de pedido superior. Si borras una opción de segmentación asignada existente, se quitará esa segmentación.

Usa advertisers.lineItems.targetingTypes.assignedTargetingOptions.create para crear las opciones de segmentación asignadas. Especifica los parámetros de segmentación en el campo details del recurso de opción de segmentación asignado que corresponda al tipo de segmentación deseado.

A continuación, se muestra un ejemplo de cómo crear una opción de segmentación asignada del tipo de segmentación 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']
);

Errores

Errores de configuración de segmentación

Existen varias reglas complejas con respecto a la segmentación en Display & Video 360. Estos se aplican en la API de Display & Video 360 a través de errores que se muestran en la creación de la opción de segmentación asignada. El error que muestra la API especificará el incumplimiento.

La mayoría de los errores se producen por la segmentación existente asignada a una línea de pedido. Usa advertisers.lineItems.targetingTypes.assignedTargetingOptions.list para recuperar todas las opciones de segmentación de un tipo determinado asignado a una línea de pedido, evalúa si la segmentación deseada es posible debido a las limitaciones y usa advertisers.lineItems.targetingTypes.assignedTargetingOptions.delete para quitar cualquier segmentación no deseada antes de intentar crear la opción de segmentación asignada deseada.

Errores de segmentación de YouTube y socios

No se puede actualizar la segmentación específica de las campañas de YouTube & Partners con la API de Display & Video 360, y tratar de hacerlo generará un error.

La segmentación de YouTube y socios consta de toda la segmentación asignada directamente a los grupos de anuncios y las líneas de pedido de YouTube & Partners, así como cualquier segmentación de los siguientes tipos de segmentación:

  • TARGETING_TYPE_SESSION_POSITION
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

Errores de simultaneidad

Si intentas actualizar la configuración o la segmentación de una sola línea de pedido a través de varias solicitudes simultáneas, se generará un error.

Si necesitas agregar o quitar varias opciones de segmentación asignadas a una sola línea de pedido al mismo tiempo, debes usar una solicitud de edición masiva. Si deseas actualizar la configuración y la segmentación de una línea de pedido, realiza la solicitud advertisers.lineItems.patch y la solicitud de segmentación relevante de forma consecutiva para asegurarte de que la segunda solicitud no se envíe hasta que la primera devuelva una respuesta.

Operaciones de segmentación masivas y de todos los recursos

Puedes usar métodos de segmentación masiva y de todos los recursos para administrar las opciones de segmentación asignadas en los diferentes tipos de segmentación:

Si quieres obtener una vista completa de la segmentación actual de una línea de pedido, quieres aplicar una configuración de segmentación predefinida a una línea de pedido o necesitas realizar varios cambios en la segmentación de una línea de pedido simultáneamente, considera usar estos métodos de segmentación.

Segmentación por listas de forma masiva

advertisers.lineItems.bulkListAssignedTargetingOptions proporciona una forma de ver todas las segmentaciones asignadas a una o más líneas de pedido en diferentes tipos de segmentación. Funciona de manera similar a cualquier otro método list. Puedes usar el parámetro de consulta filter para filtrar los resultados por TargetingType o Inheritance.

A continuación, se muestra un ejemplo de cómo enumerar todas las opciones de segmentación asignadas a una línea de pedido que hereda el socio o anunciante superior:

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

Cómo editar la segmentación de forma masiva

advertisers.lineItems.bulkEditAssignedTargetingOptions proporciona una forma de agregar y quitar varias opciones de segmentación de varios tipos de segmentación en una o más líneas de pedido a la vez.

El método toma una lista de DeleteAssignedTargetingOptionsRequests y una de CreateAssignedTargetingOptionsRequests. Un solo objeto de solicitud puede representar la eliminación o creación de varias opciones de segmentación asignadas del mismo tipo.

Si el intento de borrar o crear una opción de segmentación asignada provoca un error en una línea de pedido, se abandona la acción masiva para esa línea de pedido. La solicitud muestra una lista de líneas de pedido que se actualizaron correctamente, así como listas de líneas de pedido que no se pudieron actualizar y los errores relevantes.

Este es un ejemplo de cómo editar de forma masiva las opciones de segmentación asignadas para una o más líneas de pedido con listas de opciones de segmentación asignadas para borrar y opciones de segmentación para crear:

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');
}
Anterior
Crear recursos
Siguiente
Recuperar líneas de pedido de YouTube y Partners