Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

Edita de forma masiva las 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 se admite para los grupos de anuncios de las campañas 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. Es 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. Son 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 grupo de anuncios.
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

Opcional. Son 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)

Opcional. Son 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. Son los IDs de los grupos de anuncios que se actualizaron correctamente.
failedAdGroupIds[]

string (int64 format)

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

object (Status)

Solo salida. Es la información del 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.