Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

Ediciones masivas de opciones de segmentación para varios grupos de anuncios.

El mismo conjunto de solicitudes de eliminación y creación se aplicará a todos los grupos de anuncios especificados. Específicamente, la operación borrará las opciones de segmentación asignadas que se proporcionan en BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests de cada grupo de anuncios y, luego, creará las opciones de segmentación asignadas que se proporcionan en BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests.

Este método solo es compatible con los grupos de anuncios de generación de demanda.

Solicitud HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
advertiserId

string (int64 format)

Obligatorio. El ID del anunciante al que pertenecen los grupos de anuncios.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
Campos
adGroupIds[]

string (int64 format)

Obligatorio. Los IDs de los grupos de anuncios a los que pertenecerán las opciones de segmentación asignadas. Se puede especificar un máximo de 25 IDs de grupos de anuncios.
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

Es opcional. Las opciones de segmentación asignadas que se borrarán de forma masiva, especificadas como una lista de DeleteAssignedTargetingOptionsRequest.

Tipos de segmentación admitidos:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

Es opcional. Las opciones de segmentación asignadas que se crearán de forma masiva, especificadas como una lista de CreateAssignedTargetingOptionRequest.

Tipos de segmentación admitidos:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

Cuerpo de la respuesta

Mensaje de respuesta para adGroups.bulkEditAssignedTargetingOptions.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Campos
updatedAdGroupIds[]

string (int64 format)

Solo salida. Los IDs de los grupos de anuncios que se actualizaron correctamente.
failedAdGroupIds[]

string (int64 format)

Solo salida. Los IDs de los grupos de anuncios que no se pudieron actualizar.
errors[]

object (Status)

Solo salida. La información de error de cada grupo de anuncios que no se pudo actualizar.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/display-video

Para obtener más información, consulta OAuth 2.0 Overview.