Google Cloud Video Transcoder Client Library

1.20.0 · active · verified Thu Apr 16

The `google-cloud-video-transcoder` client library provides a Python interface for interacting with the Google Cloud Transcoder API. This API allows users to transcode video content into various formats, catering to broadcasters, production companies, and individuals needing to adapt videos for different devices. It is an actively maintained library within the larger `google-cloud-python` ecosystem, with continuous updates aligning with Google Cloud's rapid release cadence.

Common errors

```
google.auth.exceptions.DefaultCredentialsError: Could not automatically determine credentials.
```
cause The application could not find valid Google Cloud authentication credentials.

fix Authenticate your environment. For local development, run `gcloud auth application-default login` or set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable to a service account key JSON file path.
```
google.api_core.exceptions.NotFound: 404 Not Found: The requested URL was not found on this server.
```
cause This error often indicates that the specified resource (e.g., project, location, job) does not exist or is misspelled, or the Transcoder API is not enabled for the project.

fix Verify that your project ID, region, and any resource names are correct. Ensure the Transcoder API is enabled for your Google Cloud project in the API Library.
```
ImportError: cannot import name 'TranscoderServiceClient' from 'google.cloud.video.transcoder'
```
cause Incorrect import path for the client class. The client is typically located in a versioned submodule.

fix Use the correct import path: `from google.cloud.video.transcoder_v1 import TranscoderServiceClient`.

Warnings

breaking Python 3.8 and older are no longer supported. The library now requires Python 3.9 or newer.
Fix: Upgrade your Python environment to 3.9 or a newer active version. Update your `google-cloud-video-transcoder` library to the latest version after upgrading Python.
gotcha Authentication is required for all Google Cloud API interactions. Applications running locally often rely on Application Default Credentials (ADC).
Fix: Set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable to the path of your service account key file, or authenticate via the gcloud CLI using `gcloud auth application-default login`. Ensure the service account has the necessary permissions (e.g., 'Transcoder Editor' or 'Owner').
gotcha The Transcoder API and billing must be explicitly enabled in your Google Cloud project before making API calls.
Fix: Navigate to the Google Cloud Console, select your project, go to 'APIs & Services' -> 'Library', search for 'Transcoder API', and enable it. Also, ensure billing is enabled for your project.

Install

pip install google-cloud-video-transcoder Install latest version

Imports

TranscoderServiceClient

from google.cloud.video.transcoder_v1 import TranscoderServiceClient

video_transcoder_v1

wrong:

from google.cloud.video.transcoder import TranscoderServiceClient

correct:

from google.cloud import video_transcoder_v1

The client class is within a versioned submodule, typically `transcoder_v1`.

Quickstart

This quickstart demonstrates how to instantiate the `TranscoderServiceClient`. Before running, ensure you have a Google Cloud project, billing enabled, and the Transcoder API enabled. Authentication typically relies on Application Default Credentials (ADC); set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable or run `gcloud auth application-default login`.

import os
from google.cloud.video.transcoder_v1 import TranscoderServiceClient

# Set up Application Default Credentials or specify a service account key path
# os.environ['GOOGLE_APPLICATION_CREDENTIALS'] = 'path/to/your/key.json'

project_id = os.environ.get('GCP_PROJECT_ID', 'your-gcp-project-id')

try:
    client = TranscoderServiceClient()
    print(f"Successfully instantiated TranscoderServiceClient for project: {project_id}")
    # Further API calls would go here, e.g., to list jobs:
    # parent = f"projects/{project_id}/locations/us-central1"
    # for job in client.list_jobs(parent=parent):
    #     print(f"Job: {job.name}")
except Exception as e:
    print(f"An error occurred: {e}")
    print("Ensure you have authenticated and enabled the Transcoder API for your project.")

view raw JSON →