Method: advertisers.sdfuploadtasks.upload

Crea una tarea de carga de SDF. Muestra un Operation.

Una tarea de carga de SDF es una operación asíncrona de larga duración. El tipo metadata de esta operación es SdfUploadTaskMetadata. Si la solicitud se realiza correctamente, el tipo response de la operación es SdfUploadTask. La respuesta no incluirá los archivos resultantes, que se pueden recuperar con media.download.

El estado de la operación se puede recuperar con sdfuploadtask.operations.get.

Cualquier error se puede encontrar en error.message. Ten en cuenta que se espera que error.details esté vacío.

Solicitud HTTP

  • URI de carga para las solicitudes de carga de medios:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • URI de metadatos para las solicitudes de metadatos únicamente:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

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

Parámetros de ruta de acceso

Parámetros
advertiserId

string (int64 format)

Obligatorio. Es el ID del anunciante para el que se subirá el SDF.

Cuerpo de la solicitud

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

Representación JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
Campos
filename

string

Obligatorio. Es el nombre del archivo del activo, incluida la extensión. El nombre del archivo debe estar codificado en UTF-8 con un tamaño máximo de 240 bytes.
sdfVersion

enum (SdfVersion)

Obligatorio. Es la versión SDF del archivo subido. Si se establece en SDF_VERSION_UNSPECIFIED, se usará de forma predeterminada la versión que especifique el anunciante identificado. Un anunciante hereda su versión de SDF de su socio, a menos que se configure de otro modo.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia 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 OAuth 2.0 Overview.