Video API, gRPC: StylePresetService.Update

Статья создана

Обновлена 25 ноября 2025 г.

gRPC request
UpdateStylePresetRequest
Widget
Summarization
Description
operation.Operation
UpdateStylePresetMetadata
StylePreset
Widget
Summarization
Description

Updates an existing style preset's properties and visual settings.
Only fields specified in the field_mask will be updated.

gRPC request

rpc Update (UpdateStylePresetRequest) returns (operation.Operation)

UpdateStylePresetRequest

{
  "style_preset_id": "string",
  "field_mask": "google.protobuf.FieldMask",
  "title": "string",
  "background_color": "string",
  "widget_text_color_primary": "string",
  "widget_text_color_secondary": "string",
  "widget_accent_color": "string",
  "widget_block_gap": "int64",
  "widget_block_separator_color": "string",
  "player_border_radius": "int64",
  "player_color": "string",
  "playlist_selected_item_background_color": "string",
  "playlist_item_border_radius": "int64",
  "playlist_item_gap": "int64",
  "playlist_location": "WidgetLocation",
  "right_widgets": [
    {
      // Includes only one of the fields `summarization`, `description`
      "summarization": "Summarization",
      "description": "Description"
      // end of the list of possible fields
    }
  ],
  "bottom_widgets": [
    {
      // Includes only one of the fields `summarization`, `description`
      "summarization": "Summarization",
      "description": "Description"
      // end of the list of possible fields
    }
  ]
}

Field	Description
style_preset_id	string Required field. ID of the style preset. The maximum string length in characters is 50.
field_mask	google.protobuf.FieldMask Required field. Field mask specifying which fields of the style preset should be updated. Only fields specified in this mask will be modified; all other fields will retain their current values. This allows for partial updates.
title	string Style preset title. The maximum string length in characters is 50.
background_color	string Background color. Value must match the regular expression `[#a-zA-Z0-9-]*`. The maximum string length in characters is 50.
widget_text_color_primary	string Widget primary text color. Value must match the regular expression `[#a-zA-Z0-9-]*`. The maximum string length in characters is 50.
widget_text_color_secondary	string Widget secondary text color. Value must match the regular expression `[#a-zA-Z0-9-]*`. The maximum string length in characters is 50.
widget_accent_color	string Widget accent color. Value must match the regular expression `[#a-zA-Z0-9-]*`. The maximum string length in characters is 50.
widget_block_gap	int64 Gap between widget blocks. Acceptable values are 0 to 50, inclusive.
widget_block_separator_color	string Line color between widget blocks. Value must match the regular expression `[#a-zA-Z0-9-]*`. The maximum string length in characters is 50.
player_border_radius	int64 Player border radius. The minimum value is 0.
player_color	string Player color. Value must match the regular expression `[#a-zA-Z0-9]*`. The maximum string length in characters is 50.
playlist_selected_item_background_color	string Background color of selected video in playlist. Value must match the regular expression `[#a-zA-Z0-9]*`. The maximum string length in characters is 50.
playlist_item_border_radius	int64 Playlist item border radius. The minimum value is 0.
playlist_item_gap	int64 Gap between videos in playlist. Acceptable values are 0 to 50, inclusive.
playlist_location	enum WidgetLocation Playlist widget location. `WIDGET_LOCATION_UNSPECIFIED`: The widget location is not specified. `RIGHT`: Position the widget to the right of the player. `BOTTOM`: Position the widget below the player.
right_widgets[]	Widget List of widgets to display to the right of the player.
bottom_widgets[]	Widget List of widgets to display below the player.

Represents a UI component that displays additional content or functionality.
Widgets can be positioned in different locations around the player.

Field

Description

summarization

Summarization

Widget that displays video content summarization.

Includes only one of the fields summarization, description.

Specifies the type of widget to display.

description

Description

Widget that displays detailed video description.

Includes only one of the fields summarization, description.

Specifies the type of widget to display.

Widget that presents an automatically generated summary of the video content.
This helps viewers quickly understand the main points without watching the entire video.

Field	Description
Empty

Widget that displays the full description text for the video.
This can include details about the content, creators, and other relevant information.

Field	Description
Empty

operation.Operation

{
  "id": "string",
  "description": "string",
  "created_at": "google.protobuf.Timestamp",
  "created_by": "string",
  "modified_at": "google.protobuf.Timestamp",
  "done": "bool",
  "metadata": {
    "style_preset_id": "string"
  },
  // Includes only one of the fields `error`, `response`
  "error": "google.rpc.Status",
  "response": {
    "id": "string",
    "channel_id": "string",
    "title": "string",
    "background_color": "string",
    "widget_text_color_primary": "string",
    "widget_text_color_secondary": "string",
    "widget_accent_color": "string",
    "widget_block_gap": "int64",
    "widget_block_separator_color": "string",
    "player_border_radius": "int64",
    "player_color": "string",
    "playlist_selected_item_background_color": "string",
    "playlist_item_border_radius": "int64",
    "playlist_item_gap": "int64",
    "playlist_location": "WidgetLocation",
    "right_widgets": [
      {
        // Includes only one of the fields `summarization`, `description`
        "summarization": "Summarization",
        "description": "Description"
        // end of the list of possible fields
      }
    ],
    "bottom_widgets": [
      {
        // Includes only one of the fields `summarization`, `description`
        "summarization": "Summarization",
        "description": "Description"
        // end of the list of possible fields
      }
    ],
    "created_at": "google.protobuf.Timestamp",
    "updated_at": "google.protobuf.Timestamp"
  }
  // end of the list of possible fields
}

An Operation resource. For more information, see Operation.

Field	Description
id	string ID of the operation.
description	string Description of the operation. 0-256 characters long.
created_at	google.protobuf.Timestamp Creation timestamp.
created_by	string ID of the user or service account who initiated the operation.
modified_at	google.protobuf.Timestamp The time when the Operation resource was last modified.
done	bool If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
metadata	UpdateStylePresetMetadata Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
error	google.rpc.Status The error result of the operation in case of failure or cancellation. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set.
response	StylePreset The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is the standard Create/Update, the response should be the target resource of the operation. Any method that returns a long-running operation should document the response type, if any. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set.

UpdateStylePresetMetadata

Field

Description

style_preset_id

string

ID of the style preset being updated.

Entity representing a collection of visual styling settings for content presentation.
Style presets define the appearance of players, widgets, and other UI elements
to ensure consistent branding and user experience.

Field	Description
id	string Unique identifier of the style preset.
channel_id	string Identifier of the channel where this style preset is created and managed.
title	string Display name of the style preset shown in interfaces.
background_color	string Background color for the player page in hexadecimal format (e.g., "#FFFFFF").
widget_text_color_primary	string Primary text color for widgets in hexadecimal format.
widget_text_color_secondary	string Secondary text color for widgets in hexadecimal format.
widget_accent_color	string Accent color for interactive elements in widgets in hexadecimal format.
widget_block_gap	int64 Vertical spacing between widget blocks in pixels.
widget_block_separator_color	string Color of separator lines between widget blocks in hexadecimal format.
player_border_radius	int64 Corner radius of the player container in pixels.
player_color	string Primary color for player controls in hexadecimal format.
playlist_selected_item_background_color	string Background color for the currently selected item in playlists in hexadecimal format.
playlist_item_border_radius	int64 Corner radius of playlist items in pixels.
playlist_item_gap	int64 Spacing between playlist items in pixels.
playlist_location	enum WidgetLocation Position of the playlist widget relative to the player. `WIDGET_LOCATION_UNSPECIFIED`: The widget location is not specified. `RIGHT`: Position the widget to the right of the player. `BOTTOM`: Position the widget below the player.
right_widgets[]	Widget List of widgets to display to the right of the player.
bottom_widgets[]	Widget List of widgets to display below the player.
created_at	google.protobuf.Timestamp Timestamp when the style preset was initially created in the system.
updated_at	google.protobuf.Timestamp Timestamp of the last modification to the style preset or its metadata.

Widget

Represents a UI component that displays additional content or functionality.
Widgets can be positioned in different locations around the player.

Field

Description

summarization

Summarization

Widget that displays video content summarization.

Includes only one of the fields summarization, description.

Specifies the type of widget to display.

description

Description

Widget that displays detailed video description.

Includes only one of the fields summarization, description.

Specifies the type of widget to display.

Widget that presents an automatically generated summary of the video content.
This helps viewers quickly understand the main points without watching the entire video.

Field	Description
Empty

Widget that displays the full description text for the video.
This can include details about the content, creators, and other relevant information.

Field	Description
Empty

Video API, gRPC: StylePresetService.Update

gRPC requestgRPC request

UpdateStylePresetRequestUpdateStylePresetRequest

WidgetWidget

SummarizationSummarization

DescriptionDescription

operation.Operationoperation.Operation

UpdateStylePresetMetadataUpdateStylePresetMetadata

StylePresetStylePreset

WidgetWidget

SummarizationSummarization

DescriptionDescription

Была ли статья полезна?

gRPC request

UpdateStylePresetRequest

Widget

Summarization

Description

operation.Operation

UpdateStylePresetMetadata

StylePreset

Widget

Summarization

Description