Notificaciones de Pub/Sub para actualizaciones de trabajos
Organiza tus páginas con colecciones
Guarda y categoriza 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 de estado de los trabajos desde la API de Transcoder.
Configura las actualizaciones de estado de los trabajos
Para recibir actualizaciones del estado de la tarea, haz lo siguiente:
Si no tienes un tema de Pub/Sub existente, crea uno.
Para obtener información sobre cómo crear un tema de Pub/Sub, consulta Administra temas y suscripciones.
Asegúrate de configurar el campo pubsubDestination en la configuración del trabajo.
Busca la cuenta de servicio service-PROJECT_NUMBER@gcp-sa-transcoder.iam.gserviceaccount.com en la consola de Google Cloud , en la que PROJECT_NUMBER es el número del proyecto en el que habilitaste la API de Transcoder y desde el que planeas crear el feed.
Selecciona la casilla de verificación Incluir asignaciones de funciones proporcionadas por Google.
Asegúrate de que la cuenta de servicio tenga habilitado el permiso pubsub.topics.publish.
Informes de estado del trabajo
El estado del trabajo se informa una vez que este falla o finaliza correctamente. No se informan otros cambios de estado. El estado del trabajo se informa con el formato de mensaje JobResult:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (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)"]]