Únete a nosotros en vivo en Discord en el servidor de la Comunidad de Publicidad y Medición de Google y en YouTube el 26 de febrero a las 10:00 a.m. (EST). Analizaremos las nuevas funciones que se agregaron en la versión 23.1 de la API de Google Ads.

Subir videos

El objeto YouTubeVideoUploadService te permite subir videos directamente a YouTube a través de la API de Google Ads. Luego, estos videos se pueden usar como recursos en varios tipos de anuncios, como las campañas de máximo rendimiento o las campañas de generación de demanda.

Este servicio optimiza el flujo de trabajo de creación de anuncios de video, ya que se encarga del proceso de carga en YouTube y garantiza que los videos se asocien correctamente con tu cuenta.

Conceptos clave

Antes de comenzar, es importante que comprendas cómo se administran las cargas de videos y los diferentes estados por los que pueden pasar.

Propiedad del canal

Cuando subes un video, puedes especificar el canal de YouTube de destino con el campo channel_id del recurso YouTubeVideoUpload:

Canal propiedad del anunciante (de la marca): Proporciona el channel_id de un canal de YouTube propiedad del anunciante. Subir videos a un canal de marca permite tener más control sobre la privacidad y la visibilidad de los videos.
Canal administrado por Google: Si se omite channel_id, el video se sube a un canal de YouTube administrado por Google asociado a la cuenta de Google Ads.

Estados de carga

El campo state hace un seguimiento del ciclo de vida de la carga de un video de YouTube. La enumeración YouTubeVideoUploadState define los siguientes estados:

Estado	Descripción
`PENDING`	Se está subiendo el video.
`UPLOADED`	El video se subió correctamente y YouTube lo está procesando.
`PROCESSED`	El video se procesó correctamente y está listo para usarse.
`FAILED`	La carga o el procesamiento fallaron y no se pueden completar.
`REJECTED`	Se rechazó el video por motivos relacionados con la validación o la política.
`UNAVAILABLE`	El estado del video no está disponible. Es posible que se haya quitado de YouTube.

Configuración de privacidad

El campo video_privacy controla quién puede ver el video subido. La enumeración YouTubeVideoPrivacy admite lo siguiente:

PUBLIC: El video está disponible para cualquier persona en YouTube. (Solo se permite para los canales de marca).
UNLISTED: No se puede buscar el video, pero lo puede ver cualquier persona que tenga el vínculo. Esta es la opción predeterminada y única para los canales administrados por Google.

Cómo subir un video

Para subir un video, debes usar una solicitud de varias partes al método CreateYouTubeVideoUpload. La solicitud contiene los metadatos de la carga y el archivo de video.

1. Cómo iniciar la carga

Construye un CreateYouTubeVideoUploadRequest que especifique lo siguiente:

customer_id: Es tu ID de cliente de Google Ads.
you_tube_video_upload: Es un objeto YouTubeVideoUpload con los atributos video_title, video_description y, de manera opcional, channel_id y video_privacy.

Si usas una biblioteca cliente, llama al método CreateYouTubeVideoUpload y pasa tu archivo de video. La carga del video se controlará de forma interna.

Java

This example is not yet available in Java; you can take a look at the other languages.

C#

This example is not yet available in C#; you can take a look at the other languages.

PHP

This example is not yet available in PHP; you can take a look at the other languages.

Python

yt_service: YouTubeVideoUploadServiceClient = client.get_service(
    "YouTubeVideoUploadService"
)

create_upload_request: CreateYouTubeVideoUploadRequest = (
    youtube_video_upload_service.CreateYouTubeVideoUploadRequest()
)
create_upload_request.customer_id = customer_id
create_upload_request.you_tube_video_upload.video_title = "Test Video"
create_upload_request.you_tube_video_upload.video_description = (
    "Test Video Description"
)
create_upload_request.you_tube_video_upload.video_privacy = (
    client.enums.YouTubeVideoPrivacyEnum.UNLISTED
)

video_upload_resource_name: str
with open(video_file_path, "rb") as stream:
    response: CreateYouTubeVideoUploadResponse = (
        yt_service.create_you_tube_video_upload(
            stream=stream,
            request=create_upload_request,
            retry=None,
        )
    )
    print(f"Created YouTube video upload: {response.resource_name}")upload_video.py

Ruby

This example is not yet available in Ruby; you can take a look at the other languages.

Perl

This example is not yet available in Perl; you can take a look at the other languages.

curl

# 
# Use the --i curl parameter to capture response headers in the $RESPONSE
# variable.
FILE_SIZE=$(wc -c < "${VIDEO_FILE_NAME}" | tr -d '\r')
RESPONSE=$(curl -i -f -v -s --request POST \
"https://googleads.googleapis.com/resumable/upload/v${API_VERSION}/customers/${CUSTOMER_ID}:youTubeVideoUploads:create" \
--header "Content-Type: application/json" \
--header "developer-token: ${DEVELOPER_TOKEN}" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--header "X-Goog-Upload-Protocol: resumable" \
--header "X-Goog-Upload-Command: start" \
--header "X-Goog-Upload-Header-Content-Length: ${FILE_SIZE}" \
--data @- <<EOF
{
  "customer_id": "${CUSTOMER_ID}",
  "you_tube_video_upload": {
    "video_title": "${VIDEO_TITLE}",
    "video_description": "${VIDEO_DESCRIPTION}",
    "video_privacy": "UNLISTED"
  }
}
EOF
)

# Extract the value of the "x-goog-upload-url" header from the HTTP response.
UPLOAD_URL=$(echo "${RESPONSE}" \
  | grep -i '^x-goog-upload-url' \
  | awk '{print $2}' \
  | tr -d '\r')
CHUNK_SIZE=$(echo "${RESPONSE}" \
  | grep -i '^x-goog-upload-chunk-granularity' \
  | awk '{print $2}' \
  | tr -d '\r')upload_video.sh

Si usas REST, en la siguiente sección, se describe cómo administrar la carga de videos.

2. Sube el video

Cuando envías una solicitud de REST al método CreateYouTubeVideoUpload, la respuesta contiene la URL que se usará para subir los bytes del video en el encabezado de respuesta HTTP x-goog-upload-url, junto con otros metadatos, como el tamaño esperado de cada fragmento para las cargas fragmentadas.

También puedes declarar el tamaño del video que subirás inicialmente, cuando comiences el proceso, con el encabezado de solicitud HTTP x-goog-upload-header-content-length.

Para obtener una descripción completa de los encabezados HTTP que se usan en el protocolo de carga de video, consulta el siguiente ejemplo de código:

# Take the first ${CHUNK_SIZE} bytes of the video file and upload them.
head -c ${CHUNK_SIZE} ${VIDEO_FILE_NAME} | curl -i -v -X PUT "${UPLOAD_URL}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--header "X-Goog-Upload-Offset: 0" \
--header "X-Goog-Upload-Command: upload" \
--header "Content-Length: ${CHUNK_SIZE}" \
--data-binary @-

# Query the status of the upload.
QUERY_RESPONSE=$(curl -i -s -X POST "${UPLOAD_URL}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--header "X-Goog-Upload-Command: query")

# Extract the value of the "x-goog-upload-size-received" header from the HTTP
# response.
UPLOADED_BYTES=$(echo "${QUERY_RESPONSE}" \
  | grep -i '^x-goog-upload-size-received' \
  | awk '{print $2}' \
  | tr -d '\r')

echo "Uploaded ${UPLOADED_BYTES} bytes."

REMAINING_BYTES=$((FILE_SIZE - UPLOADED_BYTES))
echo "${REMAINING_BYTES} bytes remaining to upload."

FINALIZE_RESPONSE=$(tail -c ${REMAINING_BYTES} ${VIDEO_FILE_NAME} | curl -v -X PUT "${UPLOAD_URL}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--header "X-Goog-Upload-Offset: ${UPLOADED_BYTES}" \
--header "X-Goog-Upload-Command: upload, finalize" \
--data-binary @-)
UPLOADED_VIDEO_RESOURCE_NAME=$(echo $FINALIZE_RESPONSE | jq -r '.resourceName')upload_video.sh

3. Recupera el estado de carga del video

Después de iniciar la carga de un video, puedes recuperar su estado consultando el recurso you_tube_video_upload con GAQL:

Java

This example is not yet available in Java; you can take a look at the other languages.

C#

This example is not yet available in C#; you can take a look at the other languages.

PHP

This example is not yet available in PHP; you can take a look at the other languages.

Python

# Retrieve the metadata of the newly uploaded video.
query: str = f"""
    SELECT
      you_tube_video_upload.resource_name,
      you_tube_video_upload.video_id,
      you_tube_video_upload.state
    FROM you_tube_video_upload
    WHERE you_tube_video_upload.resource_name = '{video_upload_resource_name}'"""

ga_service: GoogleAdsServiceClient = client.get_service("GoogleAdsService")
stream: Iterator[SearchGoogleAdsStreamResponse] = ga_service.search_stream(
    customer_id=customer_id, query=query
)

for row in itertools.chain.from_iterable(batch.results for batch in stream):
    video = row.you_tube_video_upload
    print(
        f"Video with ID {row.you_tube_video_upload.video_id} was found in state {row.you_tube_video_upload.state}."
    )upload_video.py

Ruby

This example is not yet available in Ruby; you can take a look at the other languages.

Perl

This example is not yet available in Perl; you can take a look at the other languages.

curl

curl -i -v -X POST \
"https://qa-prod-googleads.sandbox.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:search" \
--header "Content-Type: application/json" \
  --header "Developer-Token: ${DEVELOPER_TOKEN}" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<EOF
{
  "query": "SELECT you_tube_video_upload.resource_name, you_tube_video_upload.video_id, you_tube_video_upload.state FROM you_tube_video_upload WHERE you_tube_video_upload.resource_name = '$UPLOADED_VIDEO_RESOURCE_NAME'"
}
EOFupload_video.sh

Administrar cargas de archivos

Una vez que se complete la carga de un video, podrás usarlo como recurso de video.

Usar el video subido

Después de que un video alcanza el estado PROCESSED, puedes encontrar su ID de video de YouTube en el campo video_id del recurso YouTubeVideoUpload.

Usa este video_id para crear un VideoAsset o vincularlo directamente a los tipos de anuncios que admiten videos de YouTube haciendo referencia al ID del video.

Actualizar metadatos

Puedes actualizar los metadatos de un video subido a través de esta API con el método UpdateYouTubeVideoUpload. Solo se pueden actualizar los campos video_title, video_description y video_privacy.

Cómo quitar cargas

Si necesitas borrar videos subidos con la API de Google Ads, usa el método RemoveYouTubeVideoUpload. De esta manera, se quitará el video de la biblioteca de recursos de Google Ads y de YouTube.

Recursos de mensaje para la empresa

Informes

Subir videos Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Conceptos clave

Propiedad del canal

Estados de carga

Configuración de privacidad

Cómo subir un video

1. Cómo iniciar la carga

Java

C#

PHP

Python

Ruby

Perl

curl

2. Sube el video

3. Recupera el estado de carga del video

Java

C#

PHP

Python

Ruby

Perl

curl

Administrar cargas de archivos

Usar el video subido

Actualizar metadatos

Cómo quitar cargas

Subir videos