Skip to content

Commit

Permalink
Merge branch 'main' into owl-bot-copy-TextToSpeech
Browse files Browse the repository at this point in the history
  • Loading branch information
bshaffer authored Jan 11, 2025
2 parents 95b21bc + 73559cd commit 59e9a38
Show file tree
Hide file tree
Showing 490 changed files with 11,953 additions and 39,966 deletions.
2 changes: 1 addition & 1 deletion .repo-metadata-full.json
Original file line number Diff line number Diff line change
Expand Up @@ -743,7 +743,7 @@
"GkeConnectGateway": {
"language": "php",
"distribution_name": "google/cloud-gke-connect-gateway",
"release_level": "preview",
"release_level": "stable",
"client_documentation": "https://cloud.google.com/php/docs/reference/cloud-gke-connect-gateway/latest",
"library_type": "GAPIC_AUTO",
"api_shortname": "connectgateway"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -232,6 +232,7 @@
use Google\ApiCore\ValidationException;
use Google\Auth\FetchAuthTokenInterface;
use GuzzleHttp\Promise\PromiseInterface;
use Psr\Log\LoggerInterface;

/**
* Service Description: Service Interface for the Analytics Admin API (GA4).
Expand Down Expand Up @@ -1163,16 +1164,16 @@ public static function subpropertyEventFilterName(string $property, string $subP
* listed, then parseName will check each of the supported templates, and return
* the first match.
*
* @param string $formattedName The formatted name string
* @param string $template Optional name of template to match
* @param string $formattedName The formatted name string
* @param ?string $template Optional name of template to match
*
* @return array An associative array from name component IDs to component values.
*
* @throws ValidationException If $formattedName could not be matched.
*
* @experimental
*/
public static function parseName(string $formattedName, string $template = null): array
public static function parseName(string $formattedName, ?string $template = null): array
{
return self::parseFormattedName($formattedName, $template);
}
Expand Down Expand Up @@ -1227,6 +1228,9 @@ public static function parseName(string $formattedName, string $template = null)
* @type callable $clientCertSource
* A callable which returns the client cert as a string. This can be used to
* provide a certificate and private key to the transport layer for mTLS.
* @type false|LoggerInterface $logger
* A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the
* 'GOOGLE_SDK_PHP_LOGGING' environment flag
* }
*
* @throws ValidationException
Expand Down
10 changes: 7 additions & 3 deletions AnalyticsAdmin/src/V1beta/Client/AnalyticsAdminServiceClient.php
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,7 @@
use Google\ApiCore\ValidationException;
use Google\Auth\FetchAuthTokenInterface;
use GuzzleHttp\Promise\PromiseInterface;
use Psr\Log\LoggerInterface;

/**
* Service Description: Service Interface for the Analytics Admin API (GA4).
Expand Down Expand Up @@ -489,16 +490,16 @@ public static function propertyName(string $property): string
* listed, then parseName will check each of the supported templates, and return
* the first match.
*
* @param string $formattedName The formatted name string
* @param string $template Optional name of template to match
* @param string $formattedName The formatted name string
* @param ?string $template Optional name of template to match
*
* @return array An associative array from name component IDs to component values.
*
* @throws ValidationException If $formattedName could not be matched.
*
* @experimental
*/
public static function parseName(string $formattedName, string $template = null): array
public static function parseName(string $formattedName, ?string $template = null): array
{
return self::parseFormattedName($formattedName, $template);
}
Expand Down Expand Up @@ -553,6 +554,9 @@ public static function parseName(string $formattedName, string $template = null)
* @type callable $clientCertSource
* A callable which returns the client cert as a string. This can be used to
* provide a certificate and private key to the transport layer for mTLS.
* @type false|LoggerInterface $logger
* A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the
* 'GOOGLE_SDK_PHP_LOGGING' environment flag
* }
*
* @throws ValidationException
Expand Down
10 changes: 7 additions & 3 deletions AnalyticsData/src/V1alpha/Client/AlphaAnalyticsDataClient.php
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@
use Google\LongRunning\Client\OperationsClient;
use Google\LongRunning\Operation;
use GuzzleHttp\Promise\PromiseInterface;
use Psr\Log\LoggerInterface;

/**
* Service Description: Google Analytics reporting data service.
Expand Down Expand Up @@ -306,16 +307,16 @@ public static function reportTaskName(string $property, string $reportTask): str
* listed, then parseName will check each of the supported templates, and return
* the first match.
*
* @param string $formattedName The formatted name string
* @param string $template Optional name of template to match
* @param string $formattedName The formatted name string
* @param ?string $template Optional name of template to match
*
* @return array An associative array from name component IDs to component values.
*
* @throws ValidationException If $formattedName could not be matched.
*
* @experimental
*/
public static function parseName(string $formattedName, string $template = null): array
public static function parseName(string $formattedName, ?string $template = null): array
{
return self::parseFormattedName($formattedName, $template);
}
Expand Down Expand Up @@ -370,6 +371,9 @@ public static function parseName(string $formattedName, string $template = null)
* @type callable $clientCertSource
* A callable which returns the client cert as a string. This can be used to
* provide a certificate and private key to the transport layer for mTLS.
* @type false|LoggerInterface $logger
* A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the
* 'GOOGLE_SDK_PHP_LOGGING' environment flag
* }
*
* @throws ValidationException
Expand Down
10 changes: 7 additions & 3 deletions AnalyticsData/src/V1beta/Client/BetaAnalyticsDataClient.php
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@
use Google\LongRunning\Client\OperationsClient;
use Google\LongRunning\Operation;
use GuzzleHttp\Promise\PromiseInterface;
use Psr\Log\LoggerInterface;

/**
* Service Description: Google Analytics reporting data service.
Expand Down Expand Up @@ -259,16 +260,16 @@ public static function propertyName(string $property): string
* listed, then parseName will check each of the supported templates, and return
* the first match.
*
* @param string $formattedName The formatted name string
* @param string $template Optional name of template to match
* @param string $formattedName The formatted name string
* @param ?string $template Optional name of template to match
*
* @return array An associative array from name component IDs to component values.
*
* @throws ValidationException If $formattedName could not be matched.
*
* @experimental
*/
public static function parseName(string $formattedName, string $template = null): array
public static function parseName(string $formattedName, ?string $template = null): array
{
return self::parseFormattedName($formattedName, $template);
}
Expand Down Expand Up @@ -323,6 +324,9 @@ public static function parseName(string $formattedName, string $template = null)
* @type callable $clientCertSource
* A callable which returns the client cert as a string. This can be used to
* provide a certificate and private key to the transport layer for mTLS.
* @type false|LoggerInterface $logger
* A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the
* 'GOOGLE_SDK_PHP_LOGGING' environment flag
* }
*
* @throws ValidationException
Expand Down
Binary file modified BackupDr/metadata/V1/Backupdr.php
Binary file not shown.
Binary file modified BackupDr/metadata/V1/Backupplanassociation.php
Binary file not shown.
Binary file modified BackupDr/metadata/V1/Backupvault.php
Binary file not shown.
10 changes: 8 additions & 2 deletions BackupDr/samples/V1/BackupDRClient/create_backup_plan.php
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,12 @@
* @param int $backupPlanBackupRulesBackupRetentionDays Configures the duration for which backup data will be kept. It is
* defined in “days”. The value should be greater than or equal to minimum
* enforced retention of the backup vault.
*
* Minimum value is 1 and maximum value is 90 for hourly backups.
* Minimum value is 1 and maximum value is 90 for daily backups.
* Minimum value is 7 and maximum value is 186 for weekly backups.
* Minimum value is 30 and maximum value is 732 for monthly backups.
* Minimum value is 365 and maximum value is 36159 for yearly backups.
* @param int $backupPlanBackupRulesStandardScheduleRecurrenceType Specifies the `RecurrenceType` for the schedule.
* @param int $backupPlanBackupRulesStandardScheduleBackupWindowStartHourOfDay The hour of day (0-23) when the window starts for e.g. if value
* of start hour of day is 6 that mean backup window start at 6:00.
Expand All @@ -68,8 +74,8 @@
* See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for the
* list of valid timezone names. For e.g., Europe/Paris.
* @param string $backupPlanResourceType The resource type to which the `BackupPlan` will be applied.
* Examples include, "compute.googleapis.com/Instance" and
* "storage.googleapis.com/Bucket".
* Examples include, "compute.googleapis.com/Instance",
* "sqladmin.googleapis.com/Instance", or "alloydb.googleapis.com/Cluster".
* @param string $formattedBackupPlanBackupVault Resource name of backup vault which will be used as storage
* location for backups. Format:
* projects/{project}/locations/{location}/backupVaults/{backupvault}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,8 @@
* {@see BackupDRClient::locationName()} for help formatting this field.
* @param string $backupPlanAssociationId The name of the backup plan association to create. The name must
* be unique for the specified project and location.
* @param string $backupPlanAssociationResourceType Immutable. Resource type of workload on which backupplan is
* applied
* @param string $backupPlanAssociationResource Immutable. Resource name of workload on which backupplan is
* applied
* @param string $formattedBackupPlanAssociationBackupPlan Resource name of backup plan which needs to be applied on
Expand All @@ -49,6 +51,7 @@
function create_backup_plan_association_sample(
string $formattedParent,
string $backupPlanAssociationId,
string $backupPlanAssociationResourceType,
string $backupPlanAssociationResource,
string $formattedBackupPlanAssociationBackupPlan
): void {
Expand All @@ -57,6 +60,7 @@ function create_backup_plan_association_sample(

// Prepare the request message.
$backupPlanAssociation = (new BackupPlanAssociation())
->setResourceType($backupPlanAssociationResourceType)
->setResource($backupPlanAssociationResource)
->setBackupPlan($formattedBackupPlanAssociationBackupPlan);
$request = (new CreateBackupPlanAssociationRequest())
Expand Down Expand Up @@ -97,6 +101,7 @@ function callSample(): void
{
$formattedParent = BackupDRClient::locationName('[PROJECT]', '[LOCATION]');
$backupPlanAssociationId = '[BACKUP_PLAN_ASSOCIATION_ID]';
$backupPlanAssociationResourceType = '[RESOURCE_TYPE]';
$backupPlanAssociationResource = '[RESOURCE]';
$formattedBackupPlanAssociationBackupPlan = BackupDRClient::backupPlanName(
'[PROJECT]',
Expand All @@ -107,6 +112,7 @@ function callSample(): void
create_backup_plan_association_sample(
$formattedParent,
$backupPlanAssociationId,
$backupPlanAssociationResourceType,
$backupPlanAssociationResource,
$formattedBackupPlanAssociationBackupPlan
);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,6 @@
use Google\Cloud\BackupDR\V1\Client\BackupDRClient;
use Google\Cloud\BackupDR\V1\CreateManagementServerRequest;
use Google\Cloud\BackupDR\V1\ManagementServer;
use Google\Cloud\BackupDR\V1\NetworkConfig;
use Google\Rpc\Status;

/**
Expand All @@ -49,9 +48,7 @@ function create_management_server_sample(
$backupDRClient = new BackupDRClient();

// Prepare the request message.
$managementServerNetworks = [new NetworkConfig()];
$managementServer = (new ManagementServer())
->setNetworks($managementServerNetworks);
$managementServer = new ManagementServer();
$request = (new CreateManagementServerRequest())
->setParent($formattedParent)
->setManagementServerId($managementServerId)
Expand Down
89 changes: 89 additions & 0 deletions BackupDr/samples/V1/BackupDRClient/initialize_service.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
<?php
/*
* Copyright 2025 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

/*
* GENERATED CODE WARNING
* This file was automatically generated - do not edit!
*/

require_once __DIR__ . '/../../../vendor/autoload.php';

// [START backupdr_v1_generated_BackupDR_InitializeService_sync]
use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\BackupDR\V1\Client\BackupDRClient;
use Google\Cloud\BackupDR\V1\InitializeServiceRequest;
use Google\Cloud\BackupDR\V1\InitializeServiceResponse;
use Google\Rpc\Status;

/**
* Initializes the service related config for a project.
*
* @param string $name The resource name of the serviceConfig used to initialize the
* service. Format:
* `projects/{project_id}/locations/{location}/serviceConfig`.
* @param string $resourceType The resource type to which the default service config will be
* applied. Examples include, "compute.googleapis.com/Instance" and
* "storage.googleapis.com/Bucket".
*/
function initialize_service_sample(string $name, string $resourceType): void
{
// Create a client.
$backupDRClient = new BackupDRClient();

// Prepare the request message.
$request = (new InitializeServiceRequest())
->setName($name)
->setResourceType($resourceType);

// Call the API and handle any network failures.
try {
/** @var OperationResponse $response */
$response = $backupDRClient->initializeService($request);
$response->pollUntilComplete();

if ($response->operationSucceeded()) {
/** @var InitializeServiceResponse $result */
$result = $response->getResult();
printf('Operation successful with response data: %s' . PHP_EOL, $result->serializeToJsonString());
} else {
/** @var Status $error */
$error = $response->getError();
printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
}
} catch (ApiException $ex) {
printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
}
}

/**
* Helper to execute the sample.
*
* 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.
* - It may require specifying regional endpoints when creating the service client,
* please see the apiEndpoint client configuration option for more details.
*/
function callSample(): void
{
$name = '[NAME]';
$resourceType = '[RESOURCE_TYPE]';

initialize_service_sample($name, $resourceType);
}
// [END backupdr_v1_generated_BackupDR_InitializeService_sync]
16 changes: 8 additions & 8 deletions BackupDr/src/V1/BackupPlan.php

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading

0 comments on commit 59e9a38

Please sign in to comment.