La API de Display & Video 360 v1beta2 dejó de estar disponible. Las solicitudes a una versión descontinuada pueden mostrar un error.
Debes usar Display & Video 360 API v2. Consulte nuestra guía de migración para conocer los pasos que debe seguir para migrar de la versión 1 a la versión 2.
Method: targetingTypes.targetingOptions.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muestra una lista de opciones de segmentación de un tipo determinado.
Solicitud HTTP
GET https://displayvideo.googleapis.com/v1beta2/targetingTypes/{targetingType}/targetingOptions
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros |
targetingType |
enum (TargetingType )
Obligatorio. Es el tipo de opción de segmentación que aparecerá en la lista. Valores aceptados:
TARGETING_TYPE_APP_CATEGORY
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_GENDER
TARGETING_TYPE_VIDEO_PLAYER_SIZE
TARGETING_TYPE_USER_REWARDED_CONTENT
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_CONTENT_INSTREAM_POSITION
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_BROWSER
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_ON_SCREEN_POSITION
TARGETING_TYPE_CARRIER_AND_ISP
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_VIEWABILITY
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_GEO_REGION
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_EXCHANGE
TARGETING_TYPE_SUB_EXCHANGE
TARGETING_TYPE_NATIVE_CONTENT_POSITION
TARGETING_TYPE_OMID
|
Parámetros de consulta
Parámetros |
advertiserId |
string (int64 format)
Obligatorio. Es el anunciante al que se realiza esta solicitud en el contexto.
|
pageSize |
integer
Indica el tamaño de la página solicitada. Debe ser un valor entre 1 y 100 . Si no se especifica, el valor predeterminado será 100 . Muestra el código de error INVALID_ARGUMENT si se especifica un valor no válido.
|
pageToken |
string
Un token que identifica una página de resultados que el servidor debe mostrar. Por lo general, es el valor de nextPageToken que se muestra en la llamada anterior al método targetingOptions.list . Si no se especifica, se mostrará la primera página de resultados.
|
orderBy |
string
Campo por el que se ordenará la lista. Los valores aceptables son:
targetingOptionId (predeterminada)
El orden de clasificación predeterminado es ascendente. Para especificar el orden descendente para un campo, se debe agregar el sufijo "desc" al nombre del campo. Ejemplo: targetingOptionId desc .
|
filter |
string
Permite filtrar por propiedades de opción de segmentación. Sintaxis compatible:
- Las expresiones de filtro se componen de una o más restricciones.
- Los operadores lógicos
OR pueden combinar las restricciones.
- Una restricción tiene el formato
{field} {operator} {value} .
- El operador debe ser "=" (signo igual).
- Campos admitidos:
carrierAndIspDetails.type
geoRegionDetails.geoRegionType
targetingOptionId
Ejemplos:
- Todas las opciones de segmentación de
GEO REGION que pertenecen al subtipo GEO_REGION_TYPE_COUNTRY o GEO_REGION_TYPE_STATE : geoRegionDetails.geoRegionType="GEO_REGION_TYPE_COUNTRY" OR
geoRegionDetails.geoRegionType="GEO_REGION_TYPE_STATE"
- Todas las opciones de segmentación de
CARRIER AND ISP que pertenecen al subtipo CARRIER_AND_ISP_TYPE_CARRIER : carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER" .
La longitud de este campo no debe superar los 500 caracteres.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene datos con la siguiente estructura:
Mensaje de respuesta para targetingOptions.list
.
Representación JSON |
{
"targetingOptions": [
{
object (TargetingOption )
}
],
"nextPageToken": string
} |
Campos |
targetingOptions[] |
object (TargetingOption )
Es la lista de opciones de segmentación. Esta lista no estará disponible si está vacía.
|
nextPageToken |
string
Un token para recuperar los resultados de la página siguiente. Pasa este valor en el campo pageToken en la llamada posterior al método targetingOptions.list para recuperar la siguiente página de resultados.
|
Alcances de la autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/display-video
Para obtener más información, consulta la Descripción general de OAuth 2.0.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2023-12-02 (UTC)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Falta la información que necesito"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Muy complicado o demasiados pasos"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Desactualizado"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problema de traducción"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problema con las muestras o los códigos"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Otro"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Fácil de comprender"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Resolvió mi problema"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Otro"
}]