docs(samples): include metadata file, add exclusions for samples to h…

…andwritten libraries (#1017)

feat: add WarmAndPing request for channel priming
PiperOrigin-RevId: 428795660
Source-Link: googleapis/googleapis@6cce671
Source-Link: googleapis/googleapis-gen@2282bc1
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjI4MmJjMWIwODEzNjRlYTc4MzMwMGJlOTFhOGMxNGNiNGE3MThjNCJ9
See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md
PiperOrigin-RevId: 429395631
Source-Link: googleapis/googleapis@84594b3
Source-Link: googleapis/googleapis-gen@ed74f97
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZWQ3NGY5NzBmZDgyOTE0ODc0ZTZiMjdiMDQ3NjNjZmE2NmJhZmU5YiJ9
See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md
See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Daniel Bruce <djbruce@google.com>

protos/google/bigtable/v2/bigtable.proto

@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -36,6 +36,10 @@ option (google.api.resource_definition) = {
   type: "bigtableadmin.googleapis.com/Table"
   pattern: "projects/{project}/instances/{instance}/tables/{table}"
 };
+option (google.api.resource_definition) = {
+  type: "bigtableadmin.googleapis.com/Instance"
+  pattern: "projects/{project}/instances/{instance}"
+};
 
 // Service for reading from and writing to existing Bigtable tables.
 service Bigtable {
@@ -152,6 +156,26 @@ service Bigtable {
     option (google.api.method_signature) = "table_name,row_key,predicate_filter,true_mutations,false_mutations,app_profile_id";
   }
 
+  // Warm up associated instance metadata for this connection.
+  // This call is not required but may be useful for connection keep-alive.
+  rpc PingAndWarm(PingAndWarmRequest) returns (PingAndWarmResponse) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*}:ping"
+      body: "*"
+    };
+    option (google.api.routing) = {
+      routing_parameters {
+        field: "name"
+        path_template: "{name=projects/*/instances/*}"
+      }
+      routing_parameters {
+        field: "app_profile_id"
+      }
+    };
+    option (google.api.method_signature) = "name";
+    option (google.api.method_signature) = "name,app_profile_id";
+  }
+
   // Modifies a row atomically on the server. The method reads the latest
   // existing timestamp and value from the specified columns and writes a new
   // entry based on pre-defined read/modify/write rules. The new value for the
@@ -450,6 +474,27 @@ message CheckAndMutateRowResponse {
   bool predicate_matched = 1;
 }
 
+// Request message for client connection keep-alive and warming.
+message PingAndWarmRequest {
+  // Required. The unique name of the instance to check permissions for as well as
+  // respond. Values are of the form `projects/<project>/instances/<instance>`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "bigtableadmin.googleapis.com/Instance"
+    }
+  ];
+
+  // This value specifies routing for replication. If not specified, the
+  // "default" application profile will be used.
+  string app_profile_id = 2;
+}
+
+// Response message for Bigtable.PingAndWarm connection keepalive and warming.
+message PingAndWarmResponse {
+
+}
+
 // Request message for Bigtable.ReadModifyWriteRow.
 message ReadModifyWriteRowRequest {
   // Required. The unique name of the table to which the read/modify/write rules should be

protos/google/bigtable/v2/data.proto

@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.