Regenerate apigee client (#8356)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-php-client-services/actions/workflows/codegen.yaml

Author: yoshi-code-bot

src/Apigee/GoogleCloudApigeeV1EnvironmentClientIPResolutionConfigHeaderIndexAlgorithm.php

@@ -28,8 +28,7 @@ class GoogleCloudApigeeV1EnvironmentClientIPResolutionConfigHeaderIndexAlgorithm
    */
   public $ipHeaderIndex;
   /**
-   * Required. The name of the header to extract the client ip from. We are
-   * currently only supporting the X-Forwarded-For header.
+   * Required. The name of the header to extract the client ip from.
    *
    * @var string
    */
@@ -54,8 +53,7 @@ public function getIpHeaderIndex()
     return $this->ipHeaderIndex;
   }
   /**
-   * Required. The name of the header to extract the client ip from. We are
-   * currently only supporting the X-Forwarded-For header.
+   * Required. The name of the header to extract the client ip from.
    *
    * @param string $ipHeaderName
    */

src/Apigee/GoogleCloudApigeeV1RuntimeTraceConfig.php

@@ -24,17 +24,33 @@ class GoogleCloudApigeeV1RuntimeTraceConfig extends \Google\Collection
    */
   public const EXPORTER_EXPORTER_UNSPECIFIED = 'EXPORTER_UNSPECIFIED';
   /**
-   * Jaeger exporter
+   * Exports events to Jaeger. Compatible with OpenCensus protocol.
    */
   public const EXPORTER_JAEGER = 'JAEGER';
   /**
-   * Cloudtrace exporter
+   * Exports events to Cloud Trace. Compatible with OpenCensus protocol.
    */
   public const EXPORTER_CLOUD_TRACE = 'CLOUD_TRACE';
   /**
-   * Open Telemetry Collector
+   * OpenTelemetry Collector. Compatible with OpenTelemetry protocol.
    */
   public const EXPORTER_OPEN_TELEMETRY_COLLECTOR = 'OPEN_TELEMETRY_COLLECTOR';
+  /**
+   * Exports events to Cloud Trace. Compatible with OpenTelemetry protocol.
+   */
+  public const EXPORTER_OPEN_TELEMETRY_CLOUD_TRACE = 'OPEN_TELEMETRY_CLOUD_TRACE';
+  /**
+   * Protocol unspecified. Defaults to OPEN_CENSUS.
+   */
+  public const TRACE_PROTOCOL_TRACE_PROTOCOL_UNSPECIFIED = 'TRACE_PROTOCOL_UNSPECIFIED';
+  /**
+   * Uses OpenCensus protocol.
+   */
+  public const TRACE_PROTOCOL_OPEN_CENSUS = 'OPEN_CENSUS';
+  /**
+   * Uses OpenTelemetry Protocol (OTLP).
+   */
+  public const TRACE_PROTOCOL_OTLP = 'OTLP';
   protected $collection_key = 'overrides';
   /**
    * Endpoint of the exporter.
@@ -58,13 +74,15 @@ class GoogleCloudApigeeV1RuntimeTraceConfig extends \Google\Collection
    */
   public $name;
   /**
-   * If `true`, the runtime uses OpenTelemetry Protocol (OTLP) to send trace
-   * data. Configuration Requirements (if `open_telemetry_protocol_enabled` is
-   * `true`): - Allowed `Exporter`s: `CLOUD_TRACE` or
-   * `OPEN_TELEMETRY_COLLECTOR`. - If `Exporter` is `OPEN_TELEMETRY_COLLECTOR`:
-   * - `endpoint` refers to a valid OTLP collector URL. - If `Exporter` is
-   * `CLOUD_TRACE`: - `endpoint` refers to a valid project ID
+   * Optional. If `true`, the runtime uses OpenTelemetry Protocol (OTLP) to send
+   * trace data. Configuration Requirements (if
+   * `open_telemetry_protocol_enabled` is `true`): - Allowed `Exporter`s:
+   * `CLOUD_TRACE` or `OPEN_TELEMETRY_COLLECTOR`. - If `Exporter` is
+   * `OPEN_TELEMETRY_COLLECTOR`: - `endpoint` refers to a valid OTLP collector
+   * URL. - If `Exporter` is `CLOUD_TRACE`: - `endpoint` refers to a valid
+   * project ID Deprecated: Use trace_protocol instead.
    *
+   * @deprecated
    * @var bool
    */
   public $openTelemetryProtocolEnabled;
@@ -85,6 +103,12 @@ class GoogleCloudApigeeV1RuntimeTraceConfig extends \Google\Collection
   public $revisionId;
   protected $samplingConfigType = GoogleCloudApigeeV1RuntimeTraceSamplingConfig::class;
   protected $samplingConfigDataType = '';
+  /**
+   * Optional. The trace protocol to use.
+   *
+   * @var string
+   */
+  public $traceProtocol;
 
   /**
    * Endpoint of the exporter.
@@ -108,7 +132,7 @@ public function getEndpoint()
    * consuming them. Recorded spans can be exported by registered exporters.
    *
    * Accepted values: EXPORTER_UNSPECIFIED, JAEGER, CLOUD_TRACE,
-   * OPEN_TELEMETRY_COLLECTOR
+   * OPEN_TELEMETRY_COLLECTOR, OPEN_TELEMETRY_CLOUD_TRACE
    *
    * @param self::EXPORTER_* $exporter
    */
@@ -141,20 +165,23 @@ public function getName()
     return $this->name;
   }
   /**
-   * If `true`, the runtime uses OpenTelemetry Protocol (OTLP) to send trace
-   * data. Configuration Requirements (if `open_telemetry_protocol_enabled` is
-   * `true`): - Allowed `Exporter`s: `CLOUD_TRACE` or
-   * `OPEN_TELEMETRY_COLLECTOR`. - If `Exporter` is `OPEN_TELEMETRY_COLLECTOR`:
-   * - `endpoint` refers to a valid OTLP collector URL. - If `Exporter` is
-   * `CLOUD_TRACE`: - `endpoint` refers to a valid project ID
+   * Optional. If `true`, the runtime uses OpenTelemetry Protocol (OTLP) to send
+   * trace data. Configuration Requirements (if
+   * `open_telemetry_protocol_enabled` is `true`): - Allowed `Exporter`s:
+   * `CLOUD_TRACE` or `OPEN_TELEMETRY_COLLECTOR`. - If `Exporter` is
+   * `OPEN_TELEMETRY_COLLECTOR`: - `endpoint` refers to a valid OTLP collector
+   * URL. - If `Exporter` is `CLOUD_TRACE`: - `endpoint` refers to a valid
+   * project ID Deprecated: Use trace_protocol instead.
    *
+   * @deprecated
    * @param bool $openTelemetryProtocolEnabled
    */
   public function setOpenTelemetryProtocolEnabled($openTelemetryProtocolEnabled)
   {
     $this->openTelemetryProtocolEnabled = $openTelemetryProtocolEnabled;
   }
   /**
+   * @deprecated
    * @return bool
    */
   public function getOpenTelemetryProtocolEnabled()
@@ -226,6 +253,24 @@ public function getSamplingConfig()
   {
     return $this->samplingConfig;
   }
+  /**
+   * Optional. The trace protocol to use.
+   *
+   * Accepted values: TRACE_PROTOCOL_UNSPECIFIED, OPEN_CENSUS, OTLP
+   *
+   * @param self::TRACE_PROTOCOL_* $traceProtocol
+   */
+  public function setTraceProtocol($traceProtocol)
+  {
+    $this->traceProtocol = $traceProtocol;
+  }
+  /**
+   * @return self::TRACE_PROTOCOL_*
+   */
+  public function getTraceProtocol()
+  {
+    return $this->traceProtocol;
+  }
 }
 
 // Adding a class alias for backwards compatibility with the previous class name.

src/Apigee/GoogleCloudApigeeV1RuntimeTraceConfigOverride.php

@@ -19,6 +19,18 @@
 
 class GoogleCloudApigeeV1RuntimeTraceConfigOverride extends \Google\Model
 {
+  /**
+   * Protocol unspecified. Defaults to OPEN_CENSUS.
+   */
+  public const TRACE_PROTOCOL_TRACE_PROTOCOL_UNSPECIFIED = 'TRACE_PROTOCOL_UNSPECIFIED';
+  /**
+   * Uses OpenCensus protocol.
+   */
+  public const TRACE_PROTOCOL_OPEN_CENSUS = 'OPEN_CENSUS';
+  /**
+   * Uses OpenTelemetry Protocol (OTLP).
+   */
+  public const TRACE_PROTOCOL_OTLP = 'OTLP';
   /**
    * Name of the API proxy that will have its trace configuration overridden
    * following format: `organizations/{org}/apis/{api}`
@@ -34,13 +46,15 @@ class GoogleCloudApigeeV1RuntimeTraceConfigOverride extends \Google\Model
    */
   public $name;
   /**
-   * If `true`, the runtime uses OpenTelemetry Protocol (OTLP) to send trace
-   * data. Configuration Requirements (if `open_telemetry_protocol_enabled` is
-   * `true`): - Allowed `Exporter`s: `CLOUD_TRACE` or
-   * `OPEN_TELEMETRY_COLLECTOR`. - If `Exporter` is `OPEN_TELEMETRY_COLLECTOR`:
-   * - `endpoint` refers to a valid OTLP collector URL. - If `Exporter` is
-   * `CLOUD_TRACE`: - `endpoint` refers to a valid project ID
+   * Optional. If `true`, the runtime uses OpenTelemetry Protocol (OTLP) to send
+   * trace data. Configuration Requirements (if
+   * `open_telemetry_protocol_enabled` is `true`): - Allowed `Exporter`s:
+   * `CLOUD_TRACE` or `OPEN_TELEMETRY_COLLECTOR`. - If `Exporter` is
+   * `OPEN_TELEMETRY_COLLECTOR`: - `endpoint` refers to a valid OTLP collector
+   * URL. - If `Exporter` is `CLOUD_TRACE`: - `endpoint` refers to a valid
+   * project ID Deprecated: Use trace_protocol instead.
    *
+   * @deprecated
    * @var bool
    */
   public $openTelemetryProtocolEnabled;
@@ -59,6 +73,12 @@ class GoogleCloudApigeeV1RuntimeTraceConfigOverride extends \Google\Model
   public $revisionId;
   protected $samplingConfigType = GoogleCloudApigeeV1RuntimeTraceSamplingConfig::class;
   protected $samplingConfigDataType = '';
+  /**
+   * Optional. The trace protocol to use.
+   *
+   * @var string
+   */
+  public $traceProtocol;
   /**
    * Unique ID for the configuration override. The ID will only change if the
    * override is deleted and recreated. Corresponds to name's "override" field.
@@ -102,20 +122,23 @@ public function getName()
     return $this->name;
   }
   /**
-   * If `true`, the runtime uses OpenTelemetry Protocol (OTLP) to send trace
-   * data. Configuration Requirements (if `open_telemetry_protocol_enabled` is
-   * `true`): - Allowed `Exporter`s: `CLOUD_TRACE` or
-   * `OPEN_TELEMETRY_COLLECTOR`. - If `Exporter` is `OPEN_TELEMETRY_COLLECTOR`:
-   * - `endpoint` refers to a valid OTLP collector URL. - If `Exporter` is
-   * `CLOUD_TRACE`: - `endpoint` refers to a valid project ID
+   * Optional. If `true`, the runtime uses OpenTelemetry Protocol (OTLP) to send
+   * trace data. Configuration Requirements (if
+   * `open_telemetry_protocol_enabled` is `true`): - Allowed `Exporter`s:
+   * `CLOUD_TRACE` or `OPEN_TELEMETRY_COLLECTOR`. - If `Exporter` is
+   * `OPEN_TELEMETRY_COLLECTOR`: - `endpoint` refers to a valid OTLP collector
+   * URL. - If `Exporter` is `CLOUD_TRACE`: - `endpoint` refers to a valid
+   * project ID Deprecated: Use trace_protocol instead.
    *
+   * @deprecated
    * @param bool $openTelemetryProtocolEnabled
    */
   public function setOpenTelemetryProtocolEnabled($openTelemetryProtocolEnabled)
   {
     $this->openTelemetryProtocolEnabled = $openTelemetryProtocolEnabled;
   }
   /**
+   * @deprecated
    * @return bool
    */
   public function getOpenTelemetryProtocolEnabled()
@@ -171,6 +194,24 @@ public function getSamplingConfig()
   {
     return $this->samplingConfig;
   }
+  /**
+   * Optional. The trace protocol to use.
+   *
+   * Accepted values: TRACE_PROTOCOL_UNSPECIFIED, OPEN_CENSUS, OTLP
+   *
+   * @param self::TRACE_PROTOCOL_* $traceProtocol
+   */
+  public function setTraceProtocol($traceProtocol)
+  {
+    $this->traceProtocol = $traceProtocol;
+  }
+  /**
+   * @return self::TRACE_PROTOCOL_*
+   */
+  public function getTraceProtocol()
+  {
+    return $this->traceProtocol;
+  }
   /**
    * Unique ID for the configuration override. The ID will only change if the
    * override is deleted and recreated. Corresponds to name's "override" field.

src/Apigee/GoogleCloudApigeeV1TraceConfig.php

@@ -24,17 +24,21 @@ class GoogleCloudApigeeV1TraceConfig extends \Google\Model
    */
   public const EXPORTER_EXPORTER_UNSPECIFIED = 'EXPORTER_UNSPECIFIED';
   /**
-   * Jaeger exporter
+   * Exports events to Jaeger. Compatible with OpenCensus protocol.
    */
   public const EXPORTER_JAEGER = 'JAEGER';
   /**
-   * Cloudtrace exporter
+   * Exports events to Cloud Trace. Compatible with OpenCensus protocol.
    */
   public const EXPORTER_CLOUD_TRACE = 'CLOUD_TRACE';
   /**
-   * Open Telemetry Collector
+   * OpenTelemetry Collector. Compatible with OpenTelemetry protocol.
    */
   public const EXPORTER_OPEN_TELEMETRY_COLLECTOR = 'OPEN_TELEMETRY_COLLECTOR';
+  /**
+   * Exports events to Cloud Trace. Compatible with OpenTelemetry protocol.
+   */
+  public const EXPORTER_OPEN_TELEMETRY_CLOUD_TRACE = 'OPEN_TELEMETRY_CLOUD_TRACE';
   /**
    * Required. Endpoint of the exporter.
    *
@@ -43,8 +47,9 @@ class GoogleCloudApigeeV1TraceConfig extends \Google\Model
   public $endpoint;
   /**
    * Required. Exporter that is used to view the distributed trace captured
-   * using OpenCensus. An exporter sends traces to any backend that is capable
-   * of consuming them. Recorded spans can be exported by registered exporters.
+   * using the chosen trace protocol. An exporter sends traces to any backend
+   * that is capable of consuming them. Recorded spans can be exported by
+   * registered exporters.
    *
    * @var string
    */
@@ -70,11 +75,12 @@ public function getEndpoint()
   }
   /**
    * Required. Exporter that is used to view the distributed trace captured
-   * using OpenCensus. An exporter sends traces to any backend that is capable
-   * of consuming them. Recorded spans can be exported by registered exporters.
+   * using the chosen trace protocol. An exporter sends traces to any backend
+   * that is capable of consuming them. Recorded spans can be exported by
+   * registered exporters.
    *
    * Accepted values: EXPORTER_UNSPECIFIED, JAEGER, CLOUD_TRACE,
-   * OPEN_TELEMETRY_COLLECTOR
+   * OPEN_TELEMETRY_COLLECTOR, OPEN_TELEMETRY_CLOUD_TRACE
    *
    * @param self::EXPORTER_* $exporter
    */

src/Apigee/Resource/OrganizationsDevelopersApps.php

@@ -172,9 +172,12 @@ public function get($name, $optParams = [])
    * limit is 1000.
    * @opt_param bool expand Optional. Specifies whether to expand the results. Set
    * to `true` to expand the results. This query parameter is not valid if you use
-   * the `count` or `startKey` query parameters.
+   * the `count` or `startKey` query parameters. **Note**: If set to `true`, the
+   * `apigee.developerapps.get` permission is required.
    * @opt_param bool shallowExpand Optional. Specifies whether to expand the
    * results in shallow mode. Set to `true` to expand the results in shallow mode.
+   * **Note**: If set to `true`, the `apigee.developerapps.get` permission is
+   * required.
    * @opt_param string startKey **Note**: Must be used in conjunction with the
    * `count` parameter. Name of the developer app from which to start displaying
    * the list of developer apps. For example, if you're returning 50 developer