Pub/Sub notifications for job updates
This page explains how to configure a Pub/Sub topic that you can useto receive job status updates from the Transcoder API.
Configure job status updates
To receive job status updates, do the following:
If you don't have an existing Pub/Sub topic, create a topic.To learn how to create a Pub/Sub topic, seeManaging topics and subscriptions.
Make sure to configure the
pubsubDestinationfield in the job configuration.{"config":{"pubsubDestination":{"topic":"projects/PROJECT_ID/topics/my-topic-id"}}}Create a job to enable theGoogle-managed Transcoder service account.
Find the
service-PROJECT_NUMBER@gcp-sa-transcoder.iam.gserviceaccount.comservice account in the Google Cloud console, wherePROJECT_NUMBER is the project number of the project you enabledthe Transcoder API in and you plan to create the feed from.In the Google Cloud console, go to theIAM page.
Select theInclude Google-provided role grants checkbox.
Make sure the service account has the
pubsub.topics.publishpermissionenabled.
Job status reporting
Job status is reported once the job fails or finishes successfully. No otherstate changes are reported. Job status is reported using theJobResult messageformat:
ResourcePubSubMessage{job:{object(JobResult)}}JobResult{name:string;state:string;error:{object(Status)}}For more information, refer to the following:
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-10-24 UTC.