GlcoinCore/googleapis
1
0
Fork 0
mirror of https://github.com/googleapis/googleapis.git synced 2026-08-19 13:17:47 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

feat: Add Video Transcoder V1Beta1 API.

Browse source 
PiperOrigin-RevId: 323785076
This commit is contained in:
Google APIs 2020-07-29 07:43:37 -07:00 • committed by Copybara-Service
parent 1907f0fdbd
commit d3bbea4bf8
6 changed files with 1423 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

376
google/cloud/video/transcoder/v1beta1/BUILD.bazel Normal file
View file

@ -0,0 +1,376 @@
# This file was automatically generated by BuildFileGenerator
# https://github.com/googleapis/gapic-generator/tree/master/rules_gapic/bazel
# Most of the manual changes to this file will be overwritten.
# It's **only** allowed to change the following rule attribute values:
# - names of *_gapic_assembly_* rules
# - certain parameters of *_gapic_library rules, including but not limited to:
# * extra_protoc_parameters
# * extra_protoc_file_parameters
# The complete list of preserved parameters can be found in the source code.
# This is an API workspace, having public visibility by default makes perfect sense.
package(default_visibility = ["//visibility:public"])
##############################################################################
# Common
##############################################################################
load("@rules_proto//proto:defs.bzl", "proto_library")
load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
proto_library(
name = "transcoder_proto",
srcs = [
"resources.proto",
"services.proto",
],
deps = [
"//google/api:annotations_proto",
"//google/api:client_proto",
"//google/api:field_behavior_proto",
"//google/api:resource_proto",
"@com_google_protobuf//:duration_proto",
"@com_google_protobuf//:empty_proto",
],
)
proto_library_with_info(
name = "transcoder_proto_with_info",
deps = [
":transcoder_proto",
"//google/cloud:common_resources_proto",
],
)
##############################################################################
# Java
##############################################################################
load(
"@com_google_googleapis_imports//:imports.bzl",
"java_gapic_assembly_gradle_pkg",
"java_gapic_library",
"java_gapic_test",
"java_grpc_library",
"java_proto_library",
)
java_proto_library(
name = "transcoder_java_proto",
deps = [":transcoder_proto"],
)
java_grpc_library(
name = "transcoder_java_grpc",
srcs = [":transcoder_proto"],
deps = [":transcoder_java_proto"],
)
java_gapic_library(
name = "transcoder_java_gapic",
src = ":transcoder_proto_with_info",
gapic_yaml = "transcoder_gapic.yaml",
grpc_service_config = "transcoder_grpc_service_config.json",
package = "google.cloud.video.transcoder.v1beta1",
service_yaml = "transcoder_v1beta1.yaml",
test_deps = [
":transcoder_java_grpc",
],
deps = [
":transcoder_java_proto",
],
)
java_gapic_test(
name = "transcoder_java_gapic_test_suite",
test_classes = [
"com.google.cloud.video.transcoder.v1beta1.TranscoderServiceClientTest",
],
runtime_deps = [":transcoder_java_gapic_test"],
)
# Open Source Packages
java_gapic_assembly_gradle_pkg(
name = "google-cloud-video-transcoder-v1beta1-java",
deps = [
":transcoder_java_gapic",
":transcoder_java_grpc",
":transcoder_java_proto",
":transcoder_proto",
],
)
##############################################################################
# Go
##############################################################################
load(
"@com_google_googleapis_imports//:imports.bzl",
"go_gapic_assembly_pkg",
"go_gapic_library",
"go_proto_library",
"go_test",
)
go_proto_library(
name = "transcoder_go_proto",
compilers = ["@io_bazel_rules_go//proto:go_grpc"],
importpath = "google.golang.org/genproto/googleapis/cloud/video/transcoder/v1beta1",
protos = [":transcoder_proto"],
deps = [
"//google/api:annotations_go_proto",
],
)
go_gapic_library(
name = "transcoder_go_gapic",
srcs = [":transcoder_proto_with_info"],
grpc_service_config = "transcoder_grpc_service_config.json",
importpath = "cloud.google.com/go/video/transcoder/apiv1beta1;transcoder",
service_yaml = "transcoder_v1beta1.yaml",
deps = [
":transcoder_go_proto",
"@io_bazel_rules_go//proto/wkt:duration_go_proto",
],
)
go_test(
name = "transcoder_go_gapic_test",
srcs = [":transcoder_go_gapic_srcjar_test"],
embed = [":transcoder_go_gapic"],
importpath = "cloud.google.com/go/video/transcoder/apiv1beta1",
)
# Open Source Packages
go_gapic_assembly_pkg(
name = "gapi-cloud-video-transcoder-v1beta1-go",
deps = [
":transcoder_go_gapic",
":transcoder_go_gapic_srcjar-test.srcjar",
":transcoder_go_proto",
],
)
##############################################################################
# Python
##############################################################################
load(
"@com_google_googleapis_imports//:imports.bzl",
"moved_proto_library",
"py_gapic_assembly_pkg",
"py_gapic_library",
"py_grpc_library",
"py_proto_library",
)
moved_proto_library(
name = "transcoder_moved_proto",
srcs = [":transcoder_proto"],
deps = [
"//google/api:annotations_proto",
"//google/api:client_proto",
"//google/api:field_behavior_proto",
"//google/api:resource_proto",
"@com_google_protobuf//:duration_proto",
"@com_google_protobuf//:empty_proto",
],
)
py_proto_library(
name = "transcoder_py_proto",
plugin = "@protoc_docs_plugin//:docs_plugin",
deps = [":transcoder_moved_proto"],
)
py_grpc_library(
name = "transcoder_py_grpc",
srcs = [":transcoder_moved_proto"],
deps = [":transcoder_py_proto"],
)
py_gapic_library(
name = "transcoder_py_gapic",
src = ":transcoder_proto_with_info",
gapic_yaml = "transcoder_gapic.yaml",
grpc_service_config = "transcoder_grpc_service_config.json",
package = "google.cloud.video.transcoder.v1beta1",
service_yaml = "transcoder_v1beta1.yaml",
deps = [
":transcoder_py_grpc",
":transcoder_py_proto",
],
)
# Open Source Packages
py_gapic_assembly_pkg(
name = "video-transcoder-v1beta1-py",
deps = [
":transcoder_py_gapic",
":transcoder_py_grpc",
":transcoder_py_proto",
],
)
##############################################################################
# PHP
##############################################################################
load(
"@com_google_googleapis_imports//:imports.bzl",
"php_gapic_assembly_pkg",
"php_gapic_library",
"php_grpc_library",
"php_proto_library",
)
php_proto_library(
name = "transcoder_php_proto",
deps = [":transcoder_proto"],
)
php_grpc_library(
name = "transcoder_php_grpc",
srcs = [":transcoder_proto"],
deps = [":transcoder_php_proto"],
)
php_gapic_library(
name = "transcoder_php_gapic",
src = ":transcoder_proto_with_info",
gapic_yaml = "transcoder_gapic.yaml",
grpc_service_config = "transcoder_grpc_service_config.json",
package = "google.cloud.video.transcoder.v1beta1",
service_yaml = "transcoder_v1beta1.yaml",
deps = [
":transcoder_php_grpc",
":transcoder_php_proto",
],
)
# Open Source Packages
php_gapic_assembly_pkg(
name = "google-cloud-video-transcoder-v1beta1-php",
deps = [
":transcoder_php_gapic",
":transcoder_php_grpc",
":transcoder_php_proto",
],
)
##############################################################################
# Node.js
##############################################################################
load(
"@com_google_googleapis_imports//:imports.bzl",
"nodejs_gapic_assembly_pkg",
"nodejs_gapic_library",
)
nodejs_gapic_library(
name = "transcoder_nodejs_gapic",
src = ":transcoder_proto_with_info",
grpc_service_config = "transcoder_grpc_service_config.json",
package = "google.cloud.video.transcoder.v1beta1",
service_yaml = "transcoder_v1beta1.yaml",
deps = [],
)
nodejs_gapic_assembly_pkg(
name = "video-transcoder-v1beta1-nodejs",
deps = [
":transcoder_nodejs_gapic",
":transcoder_proto",
],
)
##############################################################################
# Ruby
##############################################################################
load(
"@com_google_googleapis_imports//:imports.bzl",
"ruby_gapic_assembly_pkg",
"ruby_gapic_library",
"ruby_grpc_library",
"ruby_proto_library",
)
ruby_proto_library(
name = "transcoder_ruby_proto",
deps = [":transcoder_proto"],
)
ruby_grpc_library(
name = "transcoder_ruby_grpc",
srcs = [":transcoder_proto"],
deps = [":transcoder_ruby_proto"],
)
ruby_gapic_library(
name = "transcoder_ruby_gapic",
src = ":transcoder_proto_with_info",
gapic_yaml = "transcoder_gapic.yaml",
grpc_service_config = "transcoder_grpc_service_config.json",
package = "google.cloud.video.transcoder.v1beta1",
service_yaml = "transcoder_v1beta1.yaml",
deps = [
":transcoder_ruby_grpc",
":transcoder_ruby_proto",
],
)
# Open Source Packages
ruby_gapic_assembly_pkg(
name = "google-cloud-video-transcoder-v1beta1-ruby",
deps = [
":transcoder_ruby_gapic",
":transcoder_ruby_grpc",
":transcoder_ruby_proto",
],
)
##############################################################################
# C#
##############################################################################
load(
"@com_google_googleapis_imports//:imports.bzl",
"csharp_gapic_assembly_pkg",
"csharp_gapic_library",
"csharp_grpc_library",
"csharp_proto_library",
)
csharp_proto_library(
name = "transcoder_csharp_proto",
deps = [":transcoder_proto"],
)
csharp_grpc_library(
name = "transcoder_csharp_grpc",
srcs = [":transcoder_proto"],
deps = [":transcoder_csharp_proto"],
)
csharp_gapic_library(
name = "transcoder_csharp_gapic",
src = ":transcoder_proto_with_info",
gapic_yaml = "transcoder_gapic.yaml",
grpc_service_config = "transcoder_grpc_service_config.json",
package = "google.cloud.video.transcoder.v1beta1",
service_yaml = "transcoder_v1beta1.yaml",
deps = [
":transcoder_csharp_grpc",
":transcoder_csharp_proto",
],
)
# Open Source Packages
csharp_gapic_assembly_pkg(
name = "google-cloud-video-transcoder-v1beta1-csharp",
deps = [
":transcoder_csharp_gapic",
":transcoder_csharp_grpc",
":transcoder_csharp_proto",
],
)
##############################################################################
# C++
##############################################################################
# Put your C++ rules here

735
google/cloud/video/transcoder/v1beta1/resources.proto Normal file
View file

@ -0,0 +1,735 @@
// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
syntax = "proto3";
package google.cloud.video.transcoder.v1beta1;
import "google/api/field_behavior.proto";
import "google/api/resource.proto";
import "google/protobuf/duration.proto";
option go_package = "google.golang.org/genproto/googleapis/cloud/video/transcoder/v1beta1;transcoder";
option java_multiple_files = true;
option java_outer_classname = "ResourcesProto";
option java_package = "com.google.cloud.video.transcoder.v1beta1";
// Transcoding job resource.
message Job {
option (google.api.resource) = {
type: "transcoder.googleapis.com/Job"
pattern: "projects/{project}/locations/{location}/jobs/{job}"
};
// The origin URI.
message OriginUri {
// HLS master manifest URI. If multiple HLS master manifests are created
// only first one is listed.
string hls = 1;
// Dash manifest URI. If multiple Dash manifests are created, only the first
// one is listed.
string dash = 2;
}
// The current state of the job.
enum ProcessingState {
// The processing state is not specified.
PROCESSING_STATE_UNSPECIFIED = 0;
// The job is enqueued and will be picked up for processing soon.
PENDING = 1;
// The job is being processed.
RUNNING = 2;
// The job has been completed successfully.
SUCCEEDED = 3;
// The job has failed. For additional information, see `failure_reason` and
// `failure_details`
FAILED = 4;
}
// The resource name of the job.
// Format: `projects/{project}/locations/{location}/jobs/{job}`
string name = 1;
// Input only. Specify the `input_uri` to populate empty `uri` fields in each element of
// `Job.config.inputs` or `JobTemplate.config.inputs` when using template.
// URI of the media. It must be stored in Cloud Storage. For example,
// `gs://bucket/inputs/file.mp4`.
string input_uri = 2 [(google.api.field_behavior) = INPUT_ONLY];
// Input only. Specify the `output_uri` to populate an empty `Job.config.output.uri` or
// `JobTemplate.config.output.uri` when using template.
// URI for the output file(s). For example, `gs://my-bucket/outputs/`.
string output_uri = 3 [(google.api.field_behavior) = INPUT_ONLY];
// Specify the `job_config` for transcoding job. When you use a `template_id`
// to create a job, the `Job.config` is populated by the `JobTemplate.config`.
oneof job_config {
// Input only. Specify the `template_id` to use for populating `Job.config`. The default
// is `preset/web-hd`.
//
// Preset Transcoder templates:
// - `preset/{preset_id}`
//
// - User defined JobTemplate:
// `{job_template_id}`
string template_id = 4 [(google.api.field_behavior) = INPUT_ONLY];
// The configuration for this job.
JobConfig config = 5;
}
// Specify the priority of the job. Enter a value between 0 and 100, where 0
// is the lowest priority and 100 is the highest priority. The default is 0.
int32 priority = 6;
// Output only. The origin URI.
OriginUri origin_uri = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The current state of the job.
ProcessingState state = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Estimated fractional progress, from `0` to `1` for each
// step.
Progress progress = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. A description of the reason for the failure. This property is
// always present when `state` is `FAILED`.
string failure_reason = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. List of failure details. This property may contain additional
// information about the failure when `failure_reason` is present.
repeated FailureDetail failure_details = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// Transcoding job template resource.
message JobTemplate {
option (google.api.resource) = {
type: "transcoder.googleapis.com/JobTemplate"
pattern: "projects/{project}/locations/{location}/jobTemplates/{job_template}"
};
// The resource name of the job template.
// Format:
// `projects/{project}/locations/{location}/jobTemplates/{job_template}`
string name = 1;
// The configuration for this template.
JobConfig config = 2;
}
// Job configuration
message JobConfig {
// List of input assets stored in Cloud Storage.
repeated Input inputs = 1;
// List of `Edit atom`s. Defines the ultimate timeline of the resulting
// file or manifest.
repeated EditAtom edit_list = 2;
// List of elementary streams.
repeated ElementaryStream elementary_streams = 3;
// List of multiplexing settings for output streams.
repeated MuxStream mux_streams = 4;
// List of output manifests.
repeated Manifest manifests = 5;
// Output configuration.
Output output = 6;
// List of ad breaks. Specifies where to insert ad break tags in the output
// manifests.
repeated AdBreak ad_breaks = 7;
// Destination on Pub/Sub.
PubsubDestination pubsub_destination = 8;
// List of output sprite sheets.
repeated SpriteSheet sprite_sheets = 9;
}
// Input asset.
message Input {
// A unique key for this input. Must be specified when using advanced
// mapping and edit lists.
string key = 1;
// URI of the media. It must be stored in Cloud Storage. Example
// `gs://bucket/inputs/file.mp4`.
// If empty the value will be populated from `Job.input_uri`.
string uri = 2;
// Preprocessing configurations.
PreprocessingConfig preprocessing_config = 3;
}
// Location of output file(s) in a Cloud Storage bucket.
message Output {
// URI for the output file(s). For example, `gs://my-bucket/outputs/`.
// If empty the value is populated from `Job.output_uri`.
string uri = 1;
}
// Edit atom.
message EditAtom {
// A unique key for this atom. Must be specified when using advanced
// mapping.
string key = 1;
// List of `Input.key`s identifying files that should be used in this atom.
// The listed `inputs` must have the same timeline.
repeated string inputs = 2;
// End time in seconds for the atom, relative to the input file timeline.
// When `end_time_offset` is not specified, the `inputs` are used until
// the end of the atom.
google.protobuf.Duration end_time_offset = 3;
// Start time in seconds for the atom, relative to the input file timeline.
// The default is `0s`.
google.protobuf.Duration start_time_offset = 4;
}
// Ad break.
message AdBreak {
// Start time in seconds for the ad break, relative to the output file
// timeline. The default is `0s`.
google.protobuf.Duration start_time_offset = 1;
}
// Encoding of an input file such as an audio, video, or text track.
// Elementary streams must be packaged before
// mapping and sharing between different output formats.
message ElementaryStream {
// A unique key for this elementary stream.
string key = 4;
// Encoding of an audio, video, or text track.
oneof elementary_stream {
// Encoding of a video stream.
VideoStream video_stream = 1;
// Encoding of an audio stream.
AudioStream audio_stream = 2;
// Encoding of a text stream. For example, closed captions or subtitles.
TextStream text_stream = 3;
}
}
// Multiplexing settings for output stream.
message MuxStream {
// A unique key for this multiplexed stream. HLS media manifests will be
// named `MuxStream.key` with the `".m3u8"` extension suffix.
string key = 1;
// The name of the generated file. The default is `MuxStream.key` with the
// extension suffix corresponding to the `MuxStream.container`.
//
// Individual segments also have an incremental 10-digit zero-padded suffix
// starting from 0 before the extension, such as `"mux_stream0000000123.ts"`.
string file_name = 2;
// The container format. The default is `"mp4"`
//
// Supported container formats:
// - 'ts'
// - 'fmp4'- the corresponding file extension is `".m4s"`
// - 'mp4'
// - 'vtt'
string container = 3;
// List of `ElementaryStream.key`s multiplexed in this stream.
repeated string elementary_streams = 4;
// Segment settings for `"ts"`, `"fmp4"` and `"vtt"`.
SegmentSettings segment_settings = 5;
// Encryption settings.
Encryption encryption = 6;
}
// Manifest configuration.
message Manifest {
// The manifest type can be either `"HLS"` or `"DASH"`.
enum ManifestType {
// The manifest type is not specified.
MANIFEST_TYPE_UNSPECIFIED = 0;
// Create `"HLS"` manifest. The corresponding file extension is `".m3u8"`.
HLS = 1;
// Create `"DASH"` manifest. The corresponding file extension is `".mpd"`.
DASH = 2;
}
// The name of the generated file. The default is `"master"` with the
// extension suffix corresponding to the `Manifest.type`.
string file_name = 1;
// Required. Type of the manifest, can be "HLS" or "DASH".
ManifestType type = 2 [(google.api.field_behavior) = REQUIRED];
// Required. List of user given `MuxStream.key`s that should appear in this manifest.
//
// When `Manifest.type` is `HLS`, a media manifest with name `MuxStream.key`
// and `.m3u8` extension is generated for each element of the
// `Manifest.mux_streams`.
repeated string mux_streams = 3 [(google.api.field_behavior) = REQUIRED];
}
// A Pub/Sub destination.
message PubsubDestination {
// The name of the Pub/Sub topic to publish job completion notification
// to. For example: `projects/{project}/topics/{topic}`.
string topic = 1;
}
// Sprite sheet configuration.
message SpriteSheet {
// Format type. The default is `"jpeg"`.
//
// Supported formats:
// - 'jpeg'
string format = 1;
// Required. File name prefix for the generated sprite sheets.
//
// Each sprite sheet has an incremental 10-digit zero-padded suffix starting
// from 0 before the extension, such as `"sprite_sheet0000000123.jpeg"`.
string file_prefix = 2 [(google.api.field_behavior) = REQUIRED];
// Required. The width of sprite in pixels. Must be an even integer.
int32 sprite_width_pixels = 3 [(google.api.field_behavior) = REQUIRED];
// Required. The height of sprite in pixels. Must be an even integer.
int32 sprite_height_pixels = 4 [(google.api.field_behavior) = REQUIRED];
// The maximum number of sprites per row in a sprite sheet. The default is 0,
// which indicates no maximum limit.
int32 column_count = 5;
// The maximum number of rows per sprite sheet. When the sprite sheet is full,
// a new sprite sheet is created. The default is 0, which indicates no maximum
// limit.
int32 row_count = 6;
// Start time in seconds, relative to the output file timeline. Determines the
// first sprite to pick. The default is `0s`.
google.protobuf.Duration start_time_offset = 7;
// End time in seconds, relative to the output file timeline. When
// `end_time_offset` is not specified, the sprites are generated until the end
// of the output file.
google.protobuf.Duration end_time_offset = 8;
// Specify either total number of sprites or interval to create sprites.
oneof extraction_strategy {
// Total number of sprites. Create the specified number of sprites
// distributed evenly across the timeline of the output media. The default
// is 100.
int32 total_count = 9;
// Starting from `0s`, create sprites at regular intervals. Specify the
// interval value in seconds.
google.protobuf.Duration interval = 10;
}
}
// Preprocessing configurations.
message PreprocessingConfig {
// Color preprocessing configuration.
message Color {
// Control color saturation of the video. Enter a value between -1 and 1,
// where -1 is fully desaturated and 1 is maximum saturation. 0 is no
// change. The default is 0.
double saturation = 1;
// Control black and white contrast of the video. Enter a value between -1
// and 1, where -1 is minimum contrast and 1 is maximum contrast. 0 is no
// change. The default is 0.
double contrast = 2;
// Control brightness of the video. Enter a value between -1 and 1, where -1
// is minimum brightness and 1 is maximum brightness. 0 is no change. The
// default is 0.
double brightness = 3;
}
// Denoise preprocessing configuration.
message Denoise {
// Set strength of the denoise. Enter a value between 0 and 1. The higher
// the value, the smoother the image. 0 is no denoising. The default is 0.
double strength = 1;
// Set the denoiser mode. The default is `"standard"`.
//
// Supported denoiser modes:
// - 'standard'
// - 'grain'
string tune = 2;
}
// Deblock preprocessing configuration.
message Deblock {
// Set strength of the deblocker. Enter a value between 0 and 1. The higher
// the value, the stronger the block removal. 0 is no deblocking. The
// default is 0.
double strength = 1;
// Enable deblocker. The default is `false`.
bool enabled = 2;
}
// Audio preprocessing configuration.
message Audio {
// Specify audio loudness normalization in loudness units relative to full
// scale (LUFS). Enter a value between -24 and 0, where -24 is the Advanced
// Television Systems Committee (ATSC A/85), -23 is the EU R128 broadcast
// standard, -19 is the prior standard for online mono audio, -18 is the
// ReplayGain standard, -16 is the prior standard for stereo audio, -14 is
// the new online audio standard recommended by Spotify, as well as Amazon
// Echo, and 0 disables normalization. The default is 0.
double lufs = 1;
// Enable boosting high frequency components. The default is `false`.
bool high_boost = 2;
// Enable boosting low frequency components. The default is `false`.
bool low_boost = 3;
}
// Color preprocessing configuration.
Color color = 1;
// Denoise preprocessing configuration.
Denoise denoise = 2;
// Deblock preprocessing configuration.
Deblock deblock = 3;
// Audio preprocessing configuration.
Audio audio = 4;
}
// Video stream resource.
message VideoStream {
// Codec type. The default is `"h264"`.
//
// Supported codecs:
// - 'h264'
// - 'h265'
// - 'vp9'
string codec = 1;
// Enforce specified codec profile. The default is `"high"`.
//
// Supported codec profiles:
// - 'baseline'
// - 'main'
// - 'high'
string profile = 2;
// Enforce specified codec tune.
string tune = 3;
// Enforce specified codec preset. The default is `"veryfast"`.
string preset = 4;
// Required. The height of video in pixels. Must be an even integer.
int32 height_pixels = 5 [(google.api.field_behavior) = REQUIRED];
// Required. The width of video in pixels. Must be an even integer.
int32 width_pixels = 6 [(google.api.field_behavior) = REQUIRED];
// Pixel format to use. The default is `"yuv420p"`.
//
// Supported pixel formats:
// - 'yuv420p' pixel format.
// - 'yuv422p' pixel format.
// - 'yuv444p' pixel format.
// - 'yuv420p10' 10-bit HDR pixel format.
// - 'yuv422p10' 10-bit HDR pixel format.
// - 'yuv444p10' 10-bit HDR pixel format.
// - 'yuv420p12' 12-bit HDR pixel format.
// - 'yuv422p12' 12-bit HDR pixel format.
// - 'yuv444p12' 12-bit HDR pixel format.
string pixel_format = 7;
// Required. The video bitrate in bits per second. Must be between 1 and 1,000,000,000.
int32 bitrate_bps = 8 [(google.api.field_behavior) = REQUIRED];
// Specify the `rate_control_mode`. The default is `"vbr"`.
//
// Supported rate control modes:
// - 'vbr' - variable bitrate
// - 'crf' - constant rate factor
string rate_control_mode = 9;
// Use two-pass encoding strategy to achieve better video quality.
// `VideoStream.rate_control_mode` must be `"vbr"`. The default is `false`.
bool enable_two_pass = 10;
// Target CRF level. Must be between 10 and 36, where 10 is the highest
// quality and 36 is the most efficient compression. The default is 21.
int32 crf_level = 11;
// Size of the Video Buffering Verifier (VBV) buffer in bits. Must be greater
// than zero. The default is equal to `VideoStream.bitrate_bps`.
int32 vbv_size_bits = 12;
// Initial fullness of the Video Buffering Verifier (VBV) buffer in bits. Must
// be greater than zero. The default is equal to 90% of
// `VideoStream.vbv_size_bits`.
int32 vbv_fullness_bits = 13;
// Specifies whether an open Group of Pictures (GOP) structure should be
// allowed or not. The default is `false`.
bool allow_open_gop = 14;
// GOP mode can be either by frame count or duration.
oneof gop_mode {
// Select the GOP size based on the specified frame count. Must be greater
// than zero.
int32 gop_frame_count = 15;
// Select the GOP size based on the specified duration. The default is
// `"3s"`.
google.protobuf.Duration gop_duration = 16;
}
// The entropy coder to use. The default is `"cabac"`.
//
// Supported entropy coders:
// - 'cavlc'
// - 'cabac'
string entropy_coder = 17;
// Allow B-pyramid for reference frame selection. This may not be supported
// on all decoders. The default is `false`.
bool b_pyramid = 18;
// The number of consecutive B-frames. Must be greater than or equal to zero.
// Must be less than `VideoStream.gop_frame_count` if set. The default is 0.
int32 b_frame_count = 19;
// Required. The video frame rate in frames per second. Must be less than or equal to
// 120. Will default to the input frame rate if larger than the input frame
// rate.
double frame_rate = 20 [(google.api.field_behavior) = REQUIRED];
// Specify the intensity of the adaptive quantizer (AQ). Must be between 0 and
// 1, where 0 disables the quantizer and 1 maximizes the quantizer. A
// higher value equals a lower bitrate but smoother image. The default is 0.
double aq_strength = 21;
}
// Audio stream resource.
message AudioStream {
// The mapping for the `Job.edit_list` atoms with audio `EditAtom.inputs`.
message AudioAtom {
// The audio channel.
message AudioChannel {
// Identifies which input file, track, and channel should be used.
message AudioChannelInput {
// Required. The `Input.key` that identifies the input file.
string key = 1 [(google.api.field_behavior) = REQUIRED];
// Required. The zero-based index of the track in the input file.
int32 track = 2 [(google.api.field_behavior) = REQUIRED];
// Required. The zero-based index of the channel in the input file.
int32 channel = 3 [(google.api.field_behavior) = REQUIRED];
// Audio volume control in dB. Negative values decrease volume,
// positive values increase. The default is 0.
double gain_db = 4;
}
// List of `Job.inputs` for this audio channel.
repeated AudioChannelInput inputs = 2;
}
// Required. The `EditAtom.key` that references the atom with audio inputs in the
// `Job.edit_list`.
string key = 1 [(google.api.field_behavior) = REQUIRED];
// List of `Channel`s for this audio stream.
// for in-depth explanation.
repeated AudioChannel channels = 2;
}
// The codec for this audio stream. The default is `"aac"`.
//
// Supported audio codecs:
// - 'aac'
// - 'aac-he'
// - 'aac-he-v2'
// - 'mp3'
// - 'ac3'
// - 'eac3'
string codec = 1;
// Required. Audio bitrate in bits per second. Must be between 1 and 10,000,000.
int32 bitrate_bps = 2 [(google.api.field_behavior) = REQUIRED];
// Number of audio channels. Must be between 1 and 6. The default is 2.
int32 channel_count = 3;
// A list of channel names specifying layout of the audio channels.
// This only affects the metadata embedded in the container headers, if
// supported by the specified format. The default is `["fl", "fr"]`.
//
// Supported channel names:
// - 'fl' - Front left channel
// - 'fr' - Front right channel
// - 'sl' - Side left channel
// - 'sr' - Side right channel
// - 'fc' - Front center channel
// - 'lfe' - Low frequency
repeated string channel_layout = 4;
// The mapping for the `Job.edit_list` atoms with audio `EditAtom.inputs`.
repeated AudioAtom mapping = 5;
// The audio sample rate in Hertz. The default is 48000 Hertz.
int32 sample_rate_hertz = 6;
}
// Encoding of a text stream. For example, closed captions or subtitles.
message TextStream {
// The mapping for the `Job.edit_list` atoms with text `EditAtom.inputs`.
message TextAtom {
// Identifies which input file and track should be used.
message TextInput {
// Required. The `Input.key` that identifies the input file.
string key = 1 [(google.api.field_behavior) = REQUIRED];
// Required. The zero-based index of the track in the input file.
int32 track = 2 [(google.api.field_behavior) = REQUIRED];
}
// Required. The `EditAtom.key` that references atom with text inputs in the
// `Job.edit_list`.
string key = 1 [(google.api.field_behavior) = REQUIRED];
// List of `Job.inputs` that should be embedded in this atom. Only one
// input is supported.
repeated TextInput inputs = 2;
}
// The codec for this text stream. The default is `"webvtt"`.
//
// Supported text codecs:
// - 'srt'
// - 'ttml'
// - 'cea608'
// - 'cea708'
// - 'webvtt'
string codec = 1;
// Required. The BCP-47 language code, such as `"en-US"` or `"sr-Latn"`. For more
// information, see
// https://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
string language_code = 2 [(google.api.field_behavior) = REQUIRED];
// The mapping for the `Job.edit_list` atoms with text `EditAtom.inputs`.
repeated TextAtom mapping = 3;
}
// Segment settings for `"ts"`, `"fmp4"` and `"vtt"`.
message SegmentSettings {
// Duration of the segments in seconds. The default is `"6.0s"`.
google.protobuf.Duration segment_duration = 1;
// Required. Create an individual segment file. The default is `false`.
bool individual_segments = 3 [(google.api.field_behavior) = REQUIRED];
}
// Encryption settings.
message Encryption {
// Configuration for AES-128 encryption.
message Aes128Encryption {
// Required. URI of the key delivery service. This URI is inserted into the M3U8
// header.
string key_uri = 1 [(google.api.field_behavior) = REQUIRED];
}
// Configuration for SAMPLE-AES encryption.
message SampleAesEncryption {
// Required. URI of the key delivery service. This URI is inserted into the M3U8
// header.
string key_uri = 1 [(google.api.field_behavior) = REQUIRED];
}
// Configuration for MPEG Common Encryption (MPEG-CENC).
message MpegCommonEncryption {
// Required. 128 bit Key ID represented as lowercase hexadecimal digits for use with
// common encryption.
string key_id = 1 [(google.api.field_behavior) = REQUIRED];
// Required. Specify the encryption scheme.
//
// Supported encryption schemes:
// - 'cenc'
// - 'cbcs'
string scheme = 2 [(google.api.field_behavior) = REQUIRED];
}
// Required. 128 bit encryption key represented as lowercase hexadecimal digits.
string key = 1 [(google.api.field_behavior) = REQUIRED];
// Required. 128 bit Initialization Vector (IV) represented as lowercase hexadecimal
// digits.
string iv = 2 [(google.api.field_behavior) = REQUIRED];
// Encryption mode can be either `aes` or `cenc`.
oneof encryption_mode {
// Configuration for AES-128 encryption.
Aes128Encryption aes_128 = 3;
// Configuration for SAMPLE-AES encryption.
SampleAesEncryption sample_aes = 4;
// Configuration for MPEG Common Encryption (MPEG-CENC).
MpegCommonEncryption mpeg_cenc = 5;
}
}
// Estimated fractional progress for each step, from `0` to `1`.
message Progress {
// Estimated fractional progress for `analyzing` step.
double analyzed = 1;
// Estimated fractional progress for `encoding` step.
double encoded = 2;
// Estimated fractional progress for `uploading` step.
double uploaded = 3;
// Estimated fractional progress for `notifying` step.
double notified = 4;
}
// Additional information about the reasons for the failure.
message FailureDetail {
// A description of the failure.
string description = 1;
}

248
google/cloud/video/transcoder/v1beta1/services.proto Normal file
View file

@ -0,0 +1,248 @@
// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
syntax = "proto3";
package google.cloud.video.transcoder.v1beta1;
import "google/api/annotations.proto";
import "google/api/client.proto";
import "google/api/field_behavior.proto";
import "google/api/resource.proto";
import "google/cloud/video/transcoder/v1beta1/resources.proto";
import "google/protobuf/empty.proto";
option go_package = "google.golang.org/genproto/googleapis/cloud/video/transcoder/v1beta1;transcoder";
option java_multiple_files = true;
option java_outer_classname = "ServicesProto";
option java_package = "com.google.cloud.video.transcoder.v1beta1";
// Using the Transcoder API, you can queue asynchronous jobs for transcoding
// media into various output formats. Output formats may include different
// streaming standards such as HTTP Live Streaming (HLS) and Dynamic Adaptive
// Streaming over HTTP (DASH). You can also customize jobs using advanced
// features such as Digital Rights Management (DRM), audio equalization, content
// concatenation, and digital ad-stitch ready content generation.
service TranscoderService {
option (google.api.default_host) = "transcoder.googleapis.com";
option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
// Creates a job in the specified region.
rpc CreateJob(CreateJobRequest) returns (Job) {
option (google.api.http) = {
post: "/v1beta1/{parent=projects/*/locations/*}/jobs"
body: "job"
};
option (google.api.method_signature) = "parent,job";
}
// Lists jobs in the specified region.
rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) {
option (google.api.http) = {
get: "/v1beta1/{parent=projects/*/locations/*}/jobs"
};
option (google.api.method_signature) = "parent";
}
// Returns the job data.
rpc GetJob(GetJobRequest) returns (Job) {
option (google.api.http) = {
get: "/v1beta1/{name=projects/*/locations/*/jobs/*}"
};
option (google.api.method_signature) = "name";
}
// Deletes a job.
rpc DeleteJob(DeleteJobRequest) returns (google.protobuf.Empty) {
option (google.api.http) = {
delete: "/v1beta1/{name=projects/*/locations/*/jobs/*}"
};
option (google.api.method_signature) = "name";
}
// Creates a job template in the specified region.
rpc CreateJobTemplate(CreateJobTemplateRequest) returns (JobTemplate) {
option (google.api.http) = {
post: "/v1beta1/{parent=projects/*/locations/*}/jobTemplates"
body: "job_template"
};
option (google.api.method_signature) = "parent,job_template,job_template_id";
}
// Lists job templates in the specified region.
rpc ListJobTemplates(ListJobTemplatesRequest) returns (ListJobTemplatesResponse) {
option (google.api.http) = {
get: "/v1beta1/{parent=projects/*/locations/*}/jobTemplates"
};
option (google.api.method_signature) = "parent";
}
// Returns the job template data.
rpc GetJobTemplate(GetJobTemplateRequest) returns (JobTemplate) {
option (google.api.http) = {
get: "/v1beta1/{name=projects/*/locations/*/jobTemplates/*}"
};
option (google.api.method_signature) = "name";
}
// Deletes a job template.
rpc DeleteJobTemplate(DeleteJobTemplateRequest) returns (google.protobuf.Empty) {
option (google.api.http) = {
delete: "/v1beta1/{name=projects/*/locations/*/jobTemplates/*}"
};
option (google.api.method_signature) = "name";
}
}
// Request message for `TranscoderService.CreateJob`.
message CreateJobRequest {
// Required. The parent location to create and process this job.
// Format: projects/{project}/locations/{location}
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "locations.googleapis.com/Location"
}
];
// Required. Parameters for creating transcoding job.
Job job = 2 [(google.api.field_behavior) = REQUIRED];
}
// Request message for `TranscoderService.ListJobs`.
// The parent location from which to retrieve the collection of jobs.
message ListJobsRequest {
// Required. Format: projects/{project}/locations/{location}
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "locations.googleapis.com/Location"
}
];
// The maximum number of items to return.
int32 page_size = 2;
// The `next_page_token` value returned from a previous List request, if
// any.
string page_token = 3;
}
// Request message for `TranscoderService.GetJob`.
message GetJobRequest {
// Required. The name of the job to retrieve.
// Format: projects/{project}/locations/{location}/jobs/{job}
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "transcoder.googleapis.com/Job"
}
];
}
// Request message for `TranscoderService.DeleteJob`.
message DeleteJobRequest {
// Required. The name of the job to delete.
// Fromat: projects/{project}/locations/{location}/jobs/{job}
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "transcoder.googleapis.com/Job"
}
];
}
// Response message for `TranscoderService.ListJobs`.
message ListJobsResponse {
// List of jobs in the specified region.
repeated Job jobs = 1;
// The pagination token.
string next_page_token = 2;
}
// Request message for `TranscoderService.CreateJobTemplate`.
message CreateJobTemplateRequest {
// Required. The parent location to create this job template.
// Format: projects/{project}/locations/{location}
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "locations.googleapis.com/Location"
}
];
// Required. Parameters for creating job template.
JobTemplate job_template = 2 [(google.api.field_behavior) = REQUIRED];
// Required. The ID to use for the job template, which will become the final component
// of the job template's resource name.
//
// This value should be 4-63 characters, and valid characters
// are /[a-zA-Z0-9_-_]/.
string job_template_id = 3 [(google.api.field_behavior) = REQUIRED];
}
// Request message for `TranscoderService.ListJobTemplates`.
message ListJobTemplatesRequest {
// Required. The parent location from which to retrieve the collection of job templates.
// Format: projects/{project}/locations/{location}
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "locations.googleapis.com/Location"
}
];
// The maximum number of items to return.
int32 page_size = 2;
// The `next_page_token` value returned from a previous List request, if
// any.
string page_token = 3;
}
// Request message for `TranscoderService.GetJobTemplate`.
message GetJobTemplateRequest {
// Required. The name of the job template to retrieve.
// Format:
// projects/{project}/locations/{location}/jobTemplates/{job_template}
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "transcoder.googleapis.com/JobTemplate"
}
];
}
// Request message for `TranscoderService.DeleteJobTemplate`.
message DeleteJobTemplateRequest {
// Required. The name of the job template to delete.
// projects/{project}/locations/{location}/jobTemplates/{job_template}
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "transcoder.googleapis.com/JobTemplate"
}
];
}
// Response message for `TranscoderService.ListJobTemplates`.
message ListJobTemplatesResponse {
// List of job templates in the specified region.
repeated JobTemplate job_templates = 1;
// The pagination token.
string next_page_token = 2;
}

18
google/cloud/video/transcoder/v1beta1/transcoder_gapic.yaml Normal file
View file

@ -0,0 +1,18 @@
type: com.google.api.codegen.ConfigProto
config_schema_version: 2.0.0
language_settings:
java:
package_name: com.google.cloud.video.transcoder.v1beta1
python:
package_name: google.cloud.video.transcoder_v1beta1.gapic
go:
package_name: cloud.google.com/go/video/transcoder/apiv1beta1
csharp:
package_name: Google.Cloud.Video.Transcoder.V1beta1
ruby:
package_name: Google::Cloud::Video::Transcoder::V1beta1
php:
package_name: Google\Cloud\Video\Transcoder\V1beta1
nodejs:
package_name: transcoder.v1beta1
domain_layer_location: google-cloud

27
google/cloud/video/transcoder/v1beta1/transcoder_grpc_service_config.json Normal file
View file

@ -0,0 +1,27 @@
{
"methodConfig": [{
"name": [{ "service": "google.cloud.video.transcoder.v1beta1.TranscoderService" }],
"timeout": "60s",
"retryPolicy": {
"maxAttempts": 5,
"initialBackoff": "1s",
"maxBackoff": "10s",
"backoffMultiplier": 1.3,
"retryableStatusCodes": ["UNAVAILABLE"]
}
},
{
"name": [
{ "service": "google.cloud.video.transcoder.v1beta1.TranscoderService", "method": "CreateJob" },
{ "service": "google.cloud.video.transcoder.v1beta1.TranscoderService", "method": "ListJobs" },
{ "service": "google.cloud.video.transcoder.v1beta1.TranscoderService", "method": "GetJob" },
{ "service": "google.cloud.video.transcoder.v1beta1.TranscoderService", "method": "DeleteJob" },
{ "service": "google.cloud.video.transcoder.v1beta1.TranscoderService", "method": "CreateJobTemplate" },
{ "service": "google.cloud.video.transcoder.v1beta1.TranscoderService", "method": "ListJobTemplates" },
{ "service": "google.cloud.video.transcoder.v1beta1.TranscoderService", "method": "GetJobTemplate" },
{ "service": "google.cloud.video.transcoder.v1beta1.TranscoderService", "method": "DeleteJobTemplate" },
{ "service": "google.cloud.video.transcoder.v1beta1.TranscoderService", "method": "GetPublicKeys" }
],
"timeout": "60s"
}]
}

19
google/cloud/video/transcoder/v1beta1/transcoder_v1beta1.yaml Normal file
View file

@ -0,0 +1,19 @@
type: google.api.Service
config_version: 3
name: transcoder.googleapis.com
title: Transcoder API
apis:
- name: google.cloud.video.transcoder.v1beta1.TranscoderService
documentation:
summary: |-
This API converts video files into formats suitable for consumer
distribution.
authentication:
rules:
- selector: 'google.cloud.video.transcoder.v1beta1.TranscoderService.*'
oauth:
canonical_scopes: |-
https://www.googleapis.com/auth/cloud-platform