- Solicitud HTTP
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- ParentEntityFilter
- FileType
- FilterType
- IdFilter
- InventorySourceFilter
- Pruébala
Crea una tarea de descarga de SDF. Muestra un Operation
.
Una tarea de descarga de SDF es una operación asíncrona de larga duración. El tipo metadata
de esta operación es SdfDownloadTaskMetadata
. Si la solicitud se realiza correctamente, el tipo response
de la operación es SdfDownloadTask
. La respuesta no incluirá los archivos de descarga, que se deben recuperar con media.download
. El estado de operación se puede recuperar con sdfdownloadtask.operations.get
.
Si encuentras errores, consulta error.message
. Ten en cuenta que se espera que error.details
esté vacío.
Solicitud HTTP
POST https://displayvideo.googleapis.com/v2/sdfdownloadtasks
La URL usa la sintaxis de la transcodificación gRPC.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "version": enum ( |
Campos | |
---|---|
version |
Obligatorio. La versión de SDF del archivo descargado. Si la estableces como |
Campo de unión root_id . Obligatorio. El ID raíz determina el contexto de la solicitud de descarga. Se debe establecer exactamente un campo. Las direcciones (root_id ) solo pueden ser una de las siguientes opciones: |
|
partnerId |
Es el ID del socio para el que se descargará el SDF. |
advertiserId |
Es el ID del anunciante para el que se descargará el SDF. |
Campo de unión filtering_option . Obligatorio. Opciones que especifican los tipos de entidades y rangos que se descargarán. Se debe establecer exactamente un campo. Las direcciones (filtering_option ) solo pueden ser una de las siguientes opciones: |
|
parentEntityFilter |
Filtros de los tipos de archivos seleccionados. Las entidades de cada archivo se filtran según un conjunto elegido de entidades de filtro. Las entidades del filtro deben ser del mismo tipo o un tipo superior de los tipos de archivo seleccionados. |
idFilter |
Filtra las entidades por sus IDs. |
inventorySourceFilter |
Filtra las fuentes de inventario por sus IDs. |
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation
.
Permisos de 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.
ParentEntityFilter
Es una opción de filtrado que filtra los tipos de archivo seleccionados que pertenecen a un conjunto elegido de entidades de filtro.
Representación JSON |
---|
{ "fileType": [ enum ( |
Campos | |
---|---|
fileType[] |
Obligatorio. Tipos de archivo que se mostrarán. |
filterType |
Obligatorio. Tipo de filtro que se usa para filtrar las entidades recuperadas. |
filterIds[] |
Los ID del tipo de filtro especificado. Esto se usa para filtrar las entidades que se recuperarán. Si el tipo de filtro no es |
FileType
Los posibles tipos de archivos que se pueden descargar.
Enumeradores | |
---|---|
FILE_TYPE_UNSPECIFIED |
El valor predeterminado cuando no se especifica el tipo o se desconoce en esta versión. |
FILE_TYPE_CAMPAIGN |
Campaña. |
FILE_TYPE_MEDIA_PRODUCT |
Producto multimedia. |
FILE_TYPE_INSERTION_ORDER |
Pedido de inserción. |
FILE_TYPE_LINE_ITEM |
Línea de pedido. |
FILE_TYPE_AD_GROUP |
Grupo de anuncios de YouTube. |
FILE_TYPE_AD |
Anuncio de YouTube. |
FilterType
Tipos posibles que se pueden filtrar.
Enumeradores | |
---|---|
FILTER_TYPE_UNSPECIFIED |
El valor predeterminado cuando no se especifica el tipo o se desconoce en esta versión. |
FILTER_TYPE_NONE |
Si se selecciona, no se aplicará ningún filtro a la descarga. Solo se puede usar si se especifica un Advertiser en CreateSdfDownloadTaskRequest . |
FILTER_TYPE_ADVERTISER_ID |
ID del anunciante Si se selecciona, todos los IDs de filtro deben ser IDs de anunciante que pertenezcan al Partner especificado en CreateSdfDownloadTaskRequest . |
FILTER_TYPE_CAMPAIGN_ID |
ID de la campaña. Si se selecciona, todos los IDs de filtro deben ser IDs de campaña que pertenezcan a la Advertiser o la Partner especificada en CreateSdfDownloadTaskRequest . |
FILTER_TYPE_MEDIA_PRODUCT_ID |
ID del producto multimedia. Si se selecciona, todos los IDs de filtro deben ser IDs de productos multimedia que pertenezcan al Advertiser o al Partner especificado en CreateSdfDownloadTaskRequest . Solo se puede usar para descargar FILE_TYPE_MEDIA_PRODUCT . |
FILTER_TYPE_INSERTION_ORDER_ID |
Es el ID del pedido de inserción. Si se selecciona, todos los IDs de filtro deben ser IDs de pedido de inserción que pertenezcan a la Advertiser o la Partner especificada en CreateSdfDownloadTaskRequest . Solo se puede usar para descargar FILE_TYPE_INSERTION_ORDER , FILE_TYPE_LINE_ITEM , FILE_TYPE_AD_GROUP y FILE_TYPE_AD . |
FILTER_TYPE_LINE_ITEM_ID |
ID de la línea de pedido. Si se selecciona, todos los IDs de filtro deben ser IDs de línea de pedido que pertenezcan a la Advertiser o la Partner especificada en CreateSdfDownloadTaskRequest . Solo se puede usar para descargar FILE_TYPE_LINE_ITEM , FILE_TYPE_AD_GROUP y FILE_TYPE_AD . |
IdFilter
Una opción para filtrar entidades por sus IDs.
Representación JSON |
---|
{ "campaignIds": [ string ], "mediaProductIds": [ string ], "insertionOrderIds": [ string ], "lineItemIds": [ string ], "adGroupIds": [ string ], "adGroupAdIds": [ string ] } |
Campos | |
---|---|
campaignIds[] |
Campañas para descargar por ID. Todos los IDs deben pertenecer a la misma |
mediaProductIds[] |
Productos multimedia para descargar por ID. Todos los IDs deben pertenecer a la misma |
insertionOrderIds[] |
Pedidos de inserción para descargar por ID Todos los IDs deben pertenecer a la misma |
lineItemIds[] |
Líneas de pedido que se descargarán por ID. Todos los IDs deben pertenecer a la misma |
adGroupIds[] |
Grupos de anuncios de YouTube para descargar por ID. Todos los IDs deben pertenecer a la misma |
adGroupAdIds[] |
Anuncios de YouTube para descargar por ID. Todos los IDs deben pertenecer a la misma |
InventorySourceFilter
Es una opción para filtrar las entidades de fuente de inventario.
Representación JSON |
---|
{ "inventorySourceIds": [ string ] } |
Campos | |
---|---|
inventorySourceIds[] |
Fuentes de inventario que se descargarán por ID. Todos los IDs deben pertenecer a la misma |