go.chromium.org/luci@v0.0.0-20240309015107-7cdc2e660f33/teams/proto/v1/teams.proto (about)

     1  // Copyright 2024 The LUCI Authors.
     2  //
     3  // Licensed under the Apache License, Version 2.0 (the "License");
     4  // you may not use this file except in compliance with the License.
     5  // You may obtain a copy of the License at
     6  //
     7  //      http://www.apache.org/licenses/LICENSE-2.0
     8  //
     9  // Unless required by applicable law or agreed to in writing, software
    10  // distributed under the License is distributed on an "AS IS" BASIS,
    11  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    12  // See the License for the specific language governing permissions and
    13  // limitations under the License.
    14  
    15  syntax = "proto3";
    16  
    17  package luci.teams.v1;
    18  
    19  import "google/api/field_behavior.proto";
    20  import "google/protobuf/timestamp.proto";
    21  
    22  option go_package = "go.chromium.org/luci/teams/proto/v1";
    23  
    24  service Teams {
    25    // Get a team.
    26    // Use the resource alias 'my' to get just the current user's team.
    27    rpc Get(GetTeamRequest) returns (Team) {};
    28  
    29    // TODO: Add Update, Create, List RPCs.
    30  }
    31  
    32  message GetTeamRequest {
    33    // The resource name of the team to get.
    34    //
    35    // You can use 'my' as the id to get the team for the current user
    36    // i.e. set the name to 'teams/my'.
    37    //
    38    // Format: teams/{id}
    39    string name = 1;
    40  }
    41  
    42  // Represents a team resource.
    43  message Team {
    44    // The name of this team.
    45    // Format: team/{id}
    46    string name = 1 [
    47      (google.api.field_behavior) = OUTPUT_ONLY,
    48      (google.api.field_behavior) = IMMUTABLE
    49    ];
    50    // The time the team was made.
    51    google.protobuf.Timestamp create_time = 2
    52        [(google.api.field_behavior) = OUTPUT_ONLY];
    53  }