Notificaciones de Pub/Sub para las actualizaciones de tareas
Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
En esta página se explica cómo configurar un tema de Pub/Sub que puedes usar para recibir actualizaciones del estado de los trabajos de la API Transcoder.
Configurar actualizaciones de estado de los trabajos
Para recibir actualizaciones del estado de las tareas, haz lo siguiente:
Si no tienes ningún tema de Pub/Sub, crea uno.
Para saber cómo crear un tema de Pub/Sub, consulta Gestionar temas y suscripciones.
Asegúrate de configurar el campo pubsubDestination en la configuración de la tarea.
Busca la cuenta de servicio service-PROJECT_NUMBER@gcp-sa-transcoder.iam.gserviceaccount.com
en la consola Google Cloud , donde PROJECT_NUMBER es el número del proyecto en el que has habilitado la API Transcoder y desde el que tienes previsto crear el feed.
Selecciona la casilla Incluir concesiones de roles proporcionadas por Google.
Asegúrate de que la cuenta de servicio tenga el permiso pubsub.topics.publish habilitado.
Informes de estado de las tareas
El estado de la tarea se indica cuando falla o finaliza correctamente. No se informa de ningún otro cambio de estado. El estado de la tarea se indica mediante el mensaje JobResult con el siguiente formato:
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (UTC)."],[],[],null,["# Pub/Sub notifications for job updates\n\nThis page explains how to configure a Pub/Sub topic that you can use\nto receive job status updates from the Transcoder API.\n\nConfigure job status updates\n----------------------------\n\nTo receive job status updates, do the following:\n\n1. If you don't have an existing Pub/Sub topic, create a topic.\n To learn how to create a Pub/Sub topic, see\n [Managing topics and subscriptions](/pubsub/docs/admin).\n\n2. Make sure to configure the\n [`pubsubDestination`](/transcoder/docs/reference/rest/v1/JobConfig#FIELDS.pubsub_destination)\n field in the job configuration.\n\n {\n \"config\": {\n \"pubsubDestination\": {\n \"topic\": \"projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/topics/\u003cvar translate=\"no\"\u003emy-topic-id\u003c/var\u003e\"\n }\n }\n }\n\n3. [Create a job](/transcoder/docs/how-to/jobs) to enable the\n [Google-managed Transcoder service account](/iam/docs/service-account-types#google-managed).\n\n4. Find the\n `service-`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`@gcp-sa-transcoder.iam.gserviceaccount.com`\n service account in the Google Cloud console, where\n \u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e is the project number of the project you enabled\n the Transcoder API in and you plan to create the feed from.\n\n 1. In the Google Cloud console, go to the **IAM** page.\n\n [Go to IAM](https://console.cloud.google.com/iam-admin/iam/project)\n 2. Select the **Include Google-provided role grants** checkbox.\n\n5. Make sure the service account has the `pubsub.topics.publish` permission\n enabled.\n\nJob status reporting\n--------------------\n\nJob status is reported once the job fails or finishes successfully. No other\nstate changes are reported. Job status is reported using the `JobResult` message\nformat: \n\n Resource PubSubMessage\n {\n job: {\n object (JobResult)\n }\n }\n\n JobResult\n {\n name: string;\n state: string;\n error: {\n object (Status)\n }\n }\n\nFor more information, refer to the following:\n\n- [Job state](/transcoder/docs/reference/rest/v1/projects.locations.jobs#processingstate)\n- [Job status](/transcoder/docs/reference/rest/v1/projects.locations.jobs#status)\n- [Troubleshooting job errors](/transcoder/docs/troubleshooting)"]]