feat: [Profiler] add start_time to Profile proto

Profiler/samples/V2/ProfilerServiceClient/create_offline_profile.php

@@ -29,9 +29,14 @@
 use Google\Cloud\Profiler\V2\Profile;
 
 /**
- * CreateOfflineProfile creates a new profile resource in the offline mode.
- * The client provides the profile to create along with the profile bytes, the
- * server records it.
+ * CreateOfflineProfile creates a new profile resource in the offline
+ * mode. The client provides the profile to create along with the profile
+ * bytes, the server records it.
+ *
+ * _Direct use of this API is discouraged, please use a [supported
+ * profiler
+ * agent](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
+ * instead for profile collection._
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

Profiler/samples/V2/ProfilerServiceClient/create_profile.php

@@ -31,6 +31,11 @@
 /**
  * CreateProfile creates a new profile resource in the online mode.
  *
+ * _Direct use of this API is discouraged, please use a [supported
+ * profiler
+ * agent](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
+ * instead for profile collection._
+ *
  * The server ensures that the new profiles are created at a constant rate per
  * deployment, so the creation request may hang for some time until the next
  * profile session is available.

Profiler/samples/V2/ProfilerServiceClient/update_profile.php

@@ -34,6 +34,11 @@
  * offline mode is currently not supported: the profile content must be
  * provided at the time of the profile creation.
  *
+ * _Direct use of this API is discouraged, please use a [supported
+ * profiler
+ * agent](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
+ * instead for profile collection._
+ *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:
  *  - It may require correct/in-range values for request initialization.

Profiler/src/V2/Client/ProfilerServiceClient.php

@@ -42,9 +42,8 @@
  * Service Description: Manage the collection of continuous profiling data provided by profiling
  * agents running in the cloud or by an offline provider of profiling data.
  *
- * General guidelines:
- * * Profiles for a single deployment must be created in ascending time order.
- * * Profiles can be created in either online or offline mode, see below.
+ * __The APIs listed in this service are intended for use within our profiler
+ * agents only.__
  *
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods.
@@ -237,9 +236,14 @@ public function __call($method, $args)
     }
 
     /**
-     * CreateOfflineProfile creates a new profile resource in the offline mode.
-     * The client provides the profile to create along with the profile bytes, the
-     * server records it.
+     * CreateOfflineProfile creates a new profile resource in the offline
+     * mode. The client provides the profile to create along with the profile
+     * bytes, the server records it.
+     *
+     * _Direct use of this API is discouraged, please use a [supported
+     * profiler
+     * agent](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
+     * instead for profile collection._
      *
      * The async variant is {@see ProfilerServiceClient::createOfflineProfileAsync()} .
      *
@@ -267,6 +271,11 @@ public function createOfflineProfile(CreateOfflineProfileRequest $request, array
     /**
      * CreateProfile creates a new profile resource in the online mode.
      *
+     * _Direct use of this API is discouraged, please use a [supported
+     * profiler
+     * agent](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
+     * instead for profile collection._
+     *
      * The server ensures that the new profiles are created at a constant rate per
      * deployment, so the creation request may hang for some time until the next
      * profile session is available.
@@ -309,6 +318,11 @@ public function createProfile(CreateProfileRequest $request, array $callOptions
      * offline mode is currently not supported: the profile content must be
      * provided at the time of the profile creation.
      *
+     * _Direct use of this API is discouraged, please use a [supported
+     * profiler
+     * agent](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
+     * instead for profile collection._
+     *
      * The async variant is {@see ProfilerServiceClient::updateProfileAsync()} .
      *
      * @example samples/V2/ProfilerServiceClient/update_profile.php

Profiler/src/V2/Gapic/ProfilerServiceGapicClient.php

@@ -44,9 +44,8 @@
  * Service Description: Manage the collection of continuous profiling data provided by profiling
  * agents running in the cloud or by an offline provider of profiling data.
  *
- * General guidelines:
- * * Profiles for a single deployment must be created in ascending time order.
- * * Profiles can be created in either online or offline mode, see below.
+ * __The APIs listed in this service are intended for use within our profiler
+ * agents only.__
  *
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
@@ -287,9 +286,14 @@ public function __construct(array $options = [])
     }
 
     /**
-     * CreateOfflineProfile creates a new profile resource in the offline mode.
-     * The client provides the profile to create along with the profile bytes, the
-     * server records it.
+     * CreateOfflineProfile creates a new profile resource in the offline
+     * mode. The client provides the profile to create along with the profile
+     * bytes, the server records it.
+     *
+     * _Direct use of this API is discouraged, please use a [supported
+     * profiler
+     * agent](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
+     * instead for profile collection._
      *
      * Sample code:
      * ```
@@ -339,6 +343,11 @@ public function createOfflineProfile(array $optionalArgs = [])
     /**
      * CreateProfile creates a new profile resource in the online mode.
      *
+     * _Direct use of this API is discouraged, please use a [supported
+     * profiler
+     * agent](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
+     * instead for profile collection._
+     *
      * The server ensures that the new profiles are created at a constant rate per
      * deployment, so the creation request may hang for some time until the next
      * profile session is available.
@@ -410,6 +419,11 @@ public function createProfile(array $optionalArgs = [])
      * offline mode is currently not supported: the profile content must be
      * provided at the time of the profile creation.
      *
+     * _Direct use of this API is discouraged, please use a [supported
+     * profiler
+     * agent](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
+     * instead for profile collection._
+     *
      * Sample code:
      * ```
      * $profilerServiceClient = new ProfilerServiceClient();