feat: add GetSettings and UpdateSettings methods at the Project-level…

… to advisorynotifications.googleapis.com (#7203) docs: adding docs for new project level settings methods PiperOrigin-RevId: 621647197 Source-Link: googleapis/googleapis@39692d0 Source-Link: googleapis/googleapis-gen@5d0ab2f Copy-Tag: eyJwIjoiQWR2aXNvcnlOb3RpZmljYXRpb25zLy5Pd2xCb3QueWFtbCIsImgiOiI1ZDBhYjJmZThiMzc5ZGZhZTY1MWIzNTBmMzg5MTVmMmQ0NGFmNDJhIn0=
googleapis · Apr 5, 2024 · 04af6b4 · 04af6b4
1 parent 21a61d8
commit 04af6b4
Show file tree

Hide file tree

Showing 10 changed files with 155 additions and 27 deletions.
diff --git a/AdvisoryNotifications/metadata/V1/Service.php b/AdvisoryNotifications/metadata/V1/Service.php
diff --git a/AdvisoryNotifications/samples/V1/AdvisoryNotificationsServiceClient/get_settings.php b/AdvisoryNotifications/samples/V1/AdvisoryNotificationsServiceClient/get_settings.php
@@ -33,7 +33,8 @@
  *
  * @param string $formattedName The resource name of the settings to retrieve.
  *                              Format:
- *                              organizations/{organization}/locations/{location}/settings. Please see
+ *                              organizations/{organization}/locations/{location}/settings or
+ *                              projects/{projects}/locations/{location}/settings. Please see
  *                              {@see AdvisoryNotificationsServiceClient::settingsName()} for help formatting this field.
  */
 function get_settings_sample(string $formattedName): void

diff --git a/AdvisoryNotifications/samples/V1/AdvisoryNotificationsServiceClient/list_notifications.php b/AdvisoryNotifications/samples/V1/AdvisoryNotificationsServiceClient/list_notifications.php
@@ -34,8 +34,8 @@
  *
  * @param string $formattedParent The parent, which owns this collection of notifications.
  *                                Must be of the form "organizations/{organization}/locations/{location}"
- *                                or "projects/{project}/locations/{location}"
- *                                Please see {@see AdvisoryNotificationsServiceClient::locationName()} for help formatting this field.
+ *                                or "projects/{project}/locations/{location}". Please see
+ *                                {@see AdvisoryNotificationsServiceClient::locationName()} for help formatting this field.
  */
 function list_notifications_sample(string $formattedParent): void
 {

diff --git a/AdvisoryNotifications/src/V1/Client/AdvisoryNotificationsServiceClient.php b/AdvisoryNotifications/src/V1/Client/AdvisoryNotificationsServiceClient.php
@@ -177,6 +177,23 @@ public static function organizationLocationNotificationName(string $organization
         ]);
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * organization_location_settings resource.
+     *
+     * @param string $organization
+     * @param string $location
+     *
+     * @return string The formatted organization_location_settings resource.
+     */
+    public static function organizationLocationSettingsName(string $organization, string $location): string
+    {
+        return self::getPathTemplate('organizationLocationSettings')->render([
+            'organization' => $organization,
+            'location' => $location,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a
      * project_location resource.
@@ -213,6 +230,23 @@ public static function projectLocationNotificationName(string $project, string $
         ]);
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * project_location_settings resource.
+     *
+     * @param string $project
+     * @param string $location
+     *
+     * @return string The formatted project_location_settings resource.
+     */
+    public static function projectLocationSettingsName(string $project, string $location): string
+    {
+        return self::getPathTemplate('projectLocationSettings')->render([
+            'project' => $project,
+            'location' => $location,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a settings
      * resource.
@@ -238,8 +272,10 @@ public static function settingsName(string $organization, string $location): str
      * - notification: organizations/{organization}/locations/{location}/notifications/{notification}
      * - organizationLocation: organizations/{organization}/locations/{location}
      * - organizationLocationNotification: organizations/{organization}/locations/{location}/notifications/{notification}
+     * - organizationLocationSettings: organizations/{organization}/locations/{location}/settings
      * - projectLocation: projects/{project}/locations/{location}
      * - projectLocationNotification: projects/{project}/locations/{location}/notifications/{notification}
+     * - projectLocationSettings: projects/{project}/locations/{location}/settings
      * - settings: organizations/{organization}/locations/{location}/settings
      *
      * The optional $template argument can be supplied to specify a particular pattern,

diff --git a/AdvisoryNotifications/src/V1/Gapic/AdvisoryNotificationsServiceGapicClient.php b/AdvisoryNotifications/src/V1/Gapic/AdvisoryNotificationsServiceGapicClient.php
@@ -100,10 +100,14 @@ class AdvisoryNotificationsServiceGapicClient
 
     private static $organizationLocationNotificationNameTemplate;
 
+    private static $organizationLocationSettingsNameTemplate;
+
     private static $projectLocationNameTemplate;
 
     private static $projectLocationNotificationNameTemplate;
 
+    private static $projectLocationSettingsNameTemplate;
+
     private static $settingsNameTemplate;
 
     private static $pathTemplateMap;
@@ -180,6 +184,17 @@ private static function getOrganizationLocationNotificationNameTemplate()
         return self::$organizationLocationNotificationNameTemplate;
     }
 
+    private static function getOrganizationLocationSettingsNameTemplate()
+    {
+        if (self::$organizationLocationSettingsNameTemplate == null) {
+            self::$organizationLocationSettingsNameTemplate = new PathTemplate(
+                'organizations/{organization}/locations/{location}/settings'
+            );
+        }
+
+        return self::$organizationLocationSettingsNameTemplate;
+    }
+
     private static function getProjectLocationNameTemplate()
     {
         if (self::$projectLocationNameTemplate == null) {
@@ -202,6 +217,17 @@ private static function getProjectLocationNotificationNameTemplate()
         return self::$projectLocationNotificationNameTemplate;
     }
 
+    private static function getProjectLocationSettingsNameTemplate()
+    {
+        if (self::$projectLocationSettingsNameTemplate == null) {
+            self::$projectLocationSettingsNameTemplate = new PathTemplate(
+                'projects/{project}/locations/{location}/settings'
+            );
+        }
+
+        return self::$projectLocationSettingsNameTemplate;
+    }
+
     private static function getSettingsNameTemplate()
     {
         if (self::$settingsNameTemplate == null) {
@@ -221,8 +247,10 @@ private static function getPathTemplateMap()
                 'notification' => self::getNotificationNameTemplate(),
                 'organizationLocation' => self::getOrganizationLocationNameTemplate(),
                 'organizationLocationNotification' => self::getOrganizationLocationNotificationNameTemplate(),
+                'organizationLocationSettings' => self::getOrganizationLocationSettingsNameTemplate(),
                 'projectLocation' => self::getProjectLocationNameTemplate(),
                 'projectLocationNotification' => self::getProjectLocationNotificationNameTemplate(),
+                'projectLocationSettings' => self::getProjectLocationSettingsNameTemplate(),
                 'settings' => self::getSettingsNameTemplate(),
             ];
         }
@@ -308,6 +336,25 @@ public static function organizationLocationNotificationName(
         ]);
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * organization_location_settings resource.
+     *
+     * @param string $organization
+     * @param string $location
+     *
+     * @return string The formatted organization_location_settings resource.
+     */
+    public static function organizationLocationSettingsName(
+        $organization,
+        $location
+    ) {
+        return self::getOrganizationLocationSettingsNameTemplate()->render([
+            'organization' => $organization,
+            'location' => $location,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a
      * project_location resource.
@@ -347,6 +394,23 @@ public static function projectLocationNotificationName(
         ]);
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * project_location_settings resource.
+     *
+     * @param string $project
+     * @param string $location
+     *
+     * @return string The formatted project_location_settings resource.
+     */
+    public static function projectLocationSettingsName($project, $location)
+    {
+        return self::getProjectLocationSettingsNameTemplate()->render([
+            'project' => $project,
+            'location' => $location,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a settings
      * resource.
@@ -372,8 +436,10 @@ public static function settingsName($organization, $location)
      * - notification: organizations/{organization}/locations/{location}/notifications/{notification}
      * - organizationLocation: organizations/{organization}/locations/{location}
      * - organizationLocationNotification: organizations/{organization}/locations/{location}/notifications/{notification}
+     * - organizationLocationSettings: organizations/{organization}/locations/{location}/settings
      * - projectLocation: projects/{project}/locations/{location}
      * - projectLocationNotification: projects/{project}/locations/{location}/notifications/{notification}
+     * - projectLocationSettings: projects/{project}/locations/{location}/settings
      * - settings: organizations/{organization}/locations/{location}/settings
      *
      * The optional $template argument can be supplied to specify a particular pattern,
@@ -552,7 +618,8 @@ public function getNotification($name, array $optionalArgs = [])
      *
      * @param string $name         Required. The resource name of the settings to retrieve.
      *                             Format:
-     *                             organizations/{organization}/locations/{location}/settings.
+     *                             organizations/{organization}/locations/{location}/settings or
+     *                             projects/{projects}/locations/{location}/settings.
      * @param array  $optionalArgs {
      *     Optional.
      *
@@ -614,7 +681,7 @@ public function getSettings($name, array $optionalArgs = [])
      *
      * @param string $parent       Required. The parent, which owns this collection of notifications.
      *                             Must be of the form "organizations/{organization}/locations/{location}"
-     *                             or "projects/{project}/locations/{location}"
+     *                             or "projects/{project}/locations/{location}".
      * @param array  $optionalArgs {
      *     Optional.
      *

diff --git a/AdvisoryNotifications/src/V1/GetSettingsRequest.php b/AdvisoryNotifications/src/V1/GetSettingsRequest.php
diff --git a/AdvisoryNotifications/src/V1/ListNotificationsRequest.php b/AdvisoryNotifications/src/V1/ListNotificationsRequest.php
diff --git a/AdvisoryNotifications/src/V1/Settings.php b/AdvisoryNotifications/src/V1/Settings.php
diff --git a/AdvisoryNotifications/src/V1/resources/advisory_notifications_service_descriptor_config.php b/AdvisoryNotifications/src/V1/resources/advisory_notifications_service_descriptor_config.php
@@ -65,8 +65,10 @@
                 'notification' => 'organizations/{organization}/locations/{location}/notifications/{notification}',
                 'organizationLocation' => 'organizations/{organization}/locations/{location}',
                 'organizationLocationNotification' => 'organizations/{organization}/locations/{location}/notifications/{notification}',
+                'organizationLocationSettings' => 'organizations/{organization}/locations/{location}/settings',
                 'projectLocation' => 'projects/{project}/locations/{location}',
                 'projectLocationNotification' => 'projects/{project}/locations/{location}/notifications/{notification}',
+                'projectLocationSettings' => 'projects/{project}/locations/{location}/settings',
                 'settings' => 'organizations/{organization}/locations/{location}/settings',
             ],
         ],