aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/libs/yandex-cloud-api-protos/yandex/cloud/video/v1/thumbnail_service.proto
blob: 3b36d1c10bbd6f070b03ce1610efa10a61f88cab (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
syntax = "proto3";

package yandex.cloud.video.v1;

import "yandex/cloud/api/operation.proto";
import "yandex/cloud/operation/operation.proto";
import "yandex/cloud/video/v1/thumbnail.proto";

option go_package = "github.com/yandex-cloud/go-genproto/yandex/cloud/video/v1;video";
option java_package = "yandex.cloud.api.video.v1";

// Thumbnail management service.
service ThumbnailService {
  // List thumbnails for channel.
  rpc List(ListThumbnailRequest) returns (ListThumbnailResponse) {}

  // Create thumbnail.
  rpc Create(CreateThumbnailRequest) returns (operation.Operation) {
    option (yandex.cloud.api.operation) = {
      metadata: "CreateThumbnailMetadata"
      response: "Thumbnail"
    };
  }

  // Generate urls for download images.
  rpc BatchGenerateDownloadURLs(BatchGenerateDownloadURLsRequest) returns (BatchGenerateDownloadURLsResponse) {}

  // Generate url for upload image.
  rpc GenerateUploadURL(GenerateThumbnailUploadURLRequest) returns (GenerateThumbnailUploadURLResponse) {}
}

message ListThumbnailRequest {
  reserved 2 to 99;
  // ID of the channel.
  string channel_id = 1;

  // The maximum number of the results per page to return. Default value: 100.
  int64 page_size = 100;
  // Page token for getting the next page of the result.
  string page_token = 101;
}

message ListThumbnailResponse {
  reserved 2 to 99;
  // List of thumbnails.
  repeated Thumbnail thumbnails = 1;

  // Token for getting the next page.
  string next_page_token = 100;
}

message CreateThumbnailRequest {
  // ID of the channel.
  string channel_id = 1;
}

message CreateThumbnailMetadata {
  // ID of the thumbnail.
  string thumbnail_id = 1;
}

message BatchGenerateDownloadURLsRequest {
  // ID of the channel.
  string channel_id = 1;
  // List of thumbnails IDs.
  repeated string thumbnail_ids = 2;
}

message BatchGenerateDownloadURLsResponse {
  // List of download urls.
  repeated ThumbnailDownloadURL download_urls = 1;
}

message ThumbnailDownloadURL {
  // ID of the thumbnail.
  string thumbnail_id = 1;
  // Download url.
  string download_url = 2;
}

message GenerateThumbnailUploadURLRequest {
  // ID of the thumbnail.
  string thumbnail_id = 1;
}

message GenerateThumbnailUploadURLResponse {
  // Upload url.
  string upload_url = 1;
}