@maxim_mazurok/gapi.client.cloudsupport-v2 0.0.20230723 → 0.0.20230725

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://cloudsupport.googleapis.com/$discovery/rest?version=v2
-// Revision: 20230723
+// Revision: 20230725
 
 /// <reference types="gapi.client" />
 
@@ -462,7 +462,9 @@ declare namespace gapi.client {
             /**
              * Retrieve valid classifications to be used when creating a support case. The classications are hierarchical, with each classification containing all levels of the hierarchy,
              * separated by `" > "`. For example `"Technical Issue > Compute > Compute Engine"`. Classification IDs returned by `caseClassifications.search` are guaranteed to be valid for at least
-             * 6 months. If a given classification is deactiveated, it will immediately stop being returned. After 6 months, `case.create` requests using the classification ID will fail.
+             * six months. If a given classification is deactivated, it immediately stops being returned. After six months, `case.create` requests using the classification ID will fail. Here is an
+             * example of calling this endpoint using cURL: ```shell curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \
+             * 'https://cloudsupport.googleapis.com/v2/caseClassifications:search?query=display_name:"*Compute%20Engine*"' ```
              */
             search(request?: {
                 /** V1 error format. */
@@ -510,7 +512,10 @@ declare namespace gapi.client {
             }): Request<SearchCaseClassificationsResponse>;
         }
         interface AttachmentsResource {
-            /** Retrieve all attachments associated with a support case. */
+            /**
+             * Retrieve all attachments associated with a support case. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/23598314" curl \ --header
+             * "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/attachments" ```
+             */
             list(request?: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -557,7 +562,11 @@ declare namespace gapi.client {
             }): Request<ListAttachmentsResponse>;
         }
         interface CommentsResource {
-            /** Add a new comment to the specified Case. The comment object must have the following fields set: body. */
+            /**
+             * Add a new comment to the specified Case. The comment object must have the following fields set: body. Here is an example of calling this endpoint using cURL: ```shell
+             * case="projects/some-project/cases/43591344" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header 'Content-Type: application/json' \
+             * --data '{ "body": "This is a test comment." }' \ "https://cloudsupport.googleapis.com/v2/$case/comments" ```
+             */
             create(request: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -638,7 +647,10 @@ declare namespace gapi.client {
                     string;
             },
             body: Comment): Request<Comment>;
-            /** Retrieve all Comments associated with the Case object. */
+            /**
+             * Retrieve all comments associated with the Case object. Here is an example of calling this endpoint using cURL: ```shell case="projects/cloud-support-qa-premium/cases/43595344" curl
+             * \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/comments" ```
+             */
             list(request?: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -685,7 +697,10 @@ declare namespace gapi.client {
             }): Request<ListCommentsResponse>;
         }
         interface CasesResource {
-            /** Close the specified case. */
+            /**
+             * Close the specified case. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/43595344" curl \ --request POST \ --header
+             * "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case:close" ```
+             */
             close(request: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -768,7 +783,10 @@ declare namespace gapi.client {
             body: CloseCaseRequest): Request<Case>;
             /**
              * Create a new case and associate it with the given Google Cloud Resource. The case object must have the following fields set: `display_name`, `description`, `classification`, and
-             * `priority`.
+             * `priority`. Here is an example of calling this endpoint using cURL: ```shell parent="projects/some-project" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth
+             * print-access-token)" \ --header 'Content-Type: application/json' \ --data '{ "display_name": "Test case created by me.", "description": "a random test case, feel free to close",
+             * "classification": { "id": "100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8" }, "time_zone": "-07:00",
+             * "subscriber_email_addresses": [ "foo@domain.com", "bar@domain.com" ], "testCase": true, "priority": "P3" }' \ "https://cloudsupport.googleapis.com/v2/$parent/cases" ```
              */
             create(request: {
                 /** V1 error format. */
@@ -851,8 +869,11 @@ declare namespace gapi.client {
             },
             body: Case): Request<Case>;
             /**
-             * Escalate a case. Escalating a case will initiate the Google Cloud Support escalation management process. This operation is only available to certain Customer Care tiers. Go to
-             * https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations.
+             * Escalate a case. Escalating a case initiates the Google Cloud Support escalation management process. This operation is only available to certain Customer Care support services. Go
+             * to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which support services let you perform escalations. Here is an
+             * example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/43595344" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth
+             * print-access-token)" \ --header "Content-Type: application/json" \ --data '{ "escalation": { "reason": "BUSINESS_IMPACT", "justification": "This is a test escalation." } }' \
+             * "https://cloudsupport.googleapis.com/v2/$case:escalate" ```
              */
             escalate(request: {
                 /** V1 error format. */
@@ -934,7 +955,10 @@ declare namespace gapi.client {
                     string;
             },
             body: EscalateCaseRequest): Request<Case>;
-            /** Retrieve the specified case. */
+            /**
+             * Retrieve the specified case. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/16033687" curl \ --header "Authorization: Bearer
+             * $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case" ```
+             */
             get(request?: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -974,8 +998,9 @@ declare namespace gapi.client {
                     string;
             }): Request<Case>;
             /**
-             * Retrieve all cases under the specified parent. Note: Listing cases under an Organization returns only the cases directly parented by that organization. To retrieve all cases under
-             * an organization, including cases parented by projects under that organization, use `cases.search`.
+             * Retrieve all cases under the specified parent. Note: Listing cases under an organization returns only the cases directly parented by that organization. To retrieve all cases under
+             * an organization, including cases parented by projects under that organization, use `cases.search`. Here is an example of calling this endpoint using cURL: ```shell
+             * parent="projects/some-project" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$parent/cases" ```
              */
             list(request?: {
                 /** V1 error format. */
@@ -1029,7 +1054,11 @@ declare namespace gapi.client {
                 uploadType?:
                     string;
             }): Request<ListCasesResponse>;
-            /** Update the specified case. Only a subset of fields can be updated. */
+            /**
+             * Update the specified case. Only a subset of fields can be updated. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/43595344" curl
+             * \ --request PATCH \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ --data '{ "priority": "P1" }' \
+             * "https://cloudsupport.googleapis.com/v2/$case?updateMask=priority" ```
+             */
             patch(request: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -1124,7 +1153,10 @@ declare namespace gapi.client {
                     string;
             },
             body: Case): Request<Case>;
-            /** Search cases using the specified query. */
+            /**
+             * Search cases using the specified query. Here is an example of calling this endpoint using cURL: ```shell parent="projects/some-project" curl \ --header "Authorization: Bearer
+             * $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$parent/cases:search" ```
+             */
             search(request?: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -1188,7 +1220,11 @@ declare namespace gapi.client {
                 CommentsResource;
         }
         interface MediaResource {
-            /** Download a file attachment on a case. Note: HTTP requests must append "?alt=media" to the URL. */
+            /**
+             * Download a file attachment on a case. Note: HTTP requests must append "?alt=media" to the URL. Here is an example of calling this endpoint using cURL: ```shell
+             * name="projects/some-project/cases/43594844/attachments/0674M00000WijAnZAJ" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \
+             * "https://cloudsupport.googleapis.com/v2/$name:download?alt=media" ```
+             */
             download(request?: {
                 /** V1 error format. */
                 "$.xgafv"?:
@@ -1227,7 +1263,12 @@ declare namespace gapi.client {
                 uploadType?:
                     string;
             }): Request<Media>;
-            /** Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename. */
+            /**
+             * Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename. Here is an example of calling this endpoint using cURL:
+             * ```shell echo "This text is in a file I'm uploading using CSAPI." \ > "./example_file.txt" case="projects/some-project/cases/43594844" curl \ --header "Authorization: Bearer
+             * $(gcloud auth print-access-token)" \ --data-binary @"./example_file.txt" \
+             * "https://cloudsupport.googleapis.com/upload/v2beta/$case/attachments?attachment.filename=uploaded_via_curl.txt" ```
+             */
             upload(request: {
                 /** V1 error format. */
                 "$.xgafv"?:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.cloudsupport-v2",
-  "version": "0.0.20230723",
+  "version": "0.0.20230725",
   "description": "TypeScript typings for Google Cloud Support API v2",
   "license": "MIT",
   "author": {

package/readme.md

@@ -67,52 +67,52 @@ After that you can use Google Cloud Support API resources: <!-- TODO: make this
 ```typescript
 
 /*
-Retrieve valid classifications to be used when creating a support case. The classications are hierarchical, with each classification containing all levels of the hierarchy, separated by `" > "`. For example `"Technical Issue > Compute > Compute Engine"`. Classification IDs returned by `caseClassifications.search` are guaranteed to be valid for at least 6 months. If a given classification is deactiveated, it will immediately stop being returned. After 6 months, `case.create` requests using the classification ID will fail.
+Retrieve valid classifications to be used when creating a support case. The classications are hierarchical, with each classification containing all levels of the hierarchy, separated by `" > "`. For example `"Technical Issue > Compute > Compute Engine"`. Classification IDs returned by `caseClassifications.search` are guaranteed to be valid for at least six months. If a given classification is deactivated, it immediately stops being returned. After six months, `case.create` requests using the classification ID will fail. Here is an example of calling this endpoint using cURL: ```shell curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ 'https://cloudsupport.googleapis.com/v2/caseClassifications:search?query=display_name:"*Compute%20Engine*"' ```
 */
 await gapi.client.cloudsupport.caseClassifications.search({  });
 
 /*
-Close the specified case.
+Close the specified case. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/43595344" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case:close" ```
 */
 await gapi.client.cloudsupport.cases.close({ name: "name",  });
 
 /*
-Create a new case and associate it with the given Google Cloud Resource. The case object must have the following fields set: `display_name`, `description`, `classification`, and `priority`.
+Create a new case and associate it with the given Google Cloud Resource. The case object must have the following fields set: `display_name`, `description`, `classification`, and `priority`. Here is an example of calling this endpoint using cURL: ```shell parent="projects/some-project" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header 'Content-Type: application/json' \ --data '{ "display_name": "Test case created by me.", "description": "a random test case, feel free to close", "classification": { "id": "100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8" }, "time_zone": "-07:00", "subscriber_email_addresses": [ "foo@domain.com", "bar@domain.com" ], "testCase": true, "priority": "P3" }' \ "https://cloudsupport.googleapis.com/v2/$parent/cases" ```
 */
 await gapi.client.cloudsupport.cases.create({ parent: "parent",  });
 
 /*
-Escalate a case. Escalating a case will initiate the Google Cloud Support escalation management process. This operation is only available to certain Customer Care tiers. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations.
+Escalate a case. Escalating a case initiates the Google Cloud Support escalation management process. This operation is only available to certain Customer Care support services. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which support services let you perform escalations. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/43595344" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ --data '{ "escalation": { "reason": "BUSINESS_IMPACT", "justification": "This is a test escalation." } }' \ "https://cloudsupport.googleapis.com/v2/$case:escalate" ```
 */
 await gapi.client.cloudsupport.cases.escalate({ name: "name",  });
 
 /*
-Retrieve the specified case.
+Retrieve the specified case. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/16033687" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case" ```
 */
 await gapi.client.cloudsupport.cases.get({ name: "name",  });
 
 /*
-Retrieve all cases under the specified parent. Note: Listing cases under an Organization returns only the cases directly parented by that organization. To retrieve all cases under an organization, including cases parented by projects under that organization, use `cases.search`.
+Retrieve all cases under the specified parent. Note: Listing cases under an organization returns only the cases directly parented by that organization. To retrieve all cases under an organization, including cases parented by projects under that organization, use `cases.search`. Here is an example of calling this endpoint using cURL: ```shell parent="projects/some-project" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$parent/cases" ```
 */
 await gapi.client.cloudsupport.cases.list({ parent: "parent",  });
 
 /*
-Update the specified case. Only a subset of fields can be updated.
+Update the specified case. Only a subset of fields can be updated. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/43595344" curl \ --request PATCH \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ --data '{ "priority": "P1" }' \ "https://cloudsupport.googleapis.com/v2/$case?updateMask=priority" ```
 */
 await gapi.client.cloudsupport.cases.patch({ name: "name",  });
 
 /*
-Search cases using the specified query.
+Search cases using the specified query. Here is an example of calling this endpoint using cURL: ```shell parent="projects/some-project" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$parent/cases:search" ```
 */
 await gapi.client.cloudsupport.cases.search({ parent: "parent",  });
 
 /*
-Download a file attachment on a case. Note: HTTP requests must append "?alt=media" to the URL.
+Download a file attachment on a case. Note: HTTP requests must append "?alt=media" to the URL. Here is an example of calling this endpoint using cURL: ```shell name="projects/some-project/cases/43594844/attachments/0674M00000WijAnZAJ" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$name:download?alt=media" ```
 */
 await gapi.client.cloudsupport.media.download({ name: "name",  });
 
 /*
-Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename.
+Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename. Here is an example of calling this endpoint using cURL: ```shell echo "This text is in a file I'm uploading using CSAPI." \ > "./example_file.txt" case="projects/some-project/cases/43594844" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --data-binary @"./example_file.txt" \ "https://cloudsupport.googleapis.com/upload/v2beta/$case/attachments?attachment.filename=uploaded_via_curl.txt" ```
 */
 await gapi.client.cloudsupport.media.upload({ parent: "parent",  });
 ```

package/tests.ts

@@ -3,7 +3,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 
-// Revision: 20230723
+// Revision: 20230725
 
 gapi.load('client', async () => {
     /** now we can use gapi.client */
@@ -31,22 +31,30 @@ gapi.load('client', async () => {
     async function run() {
         /**
          * Retrieve valid classifications to be used when creating a support case. The classications are hierarchical, with each classification containing all levels of the hierarchy, separated by
-         * `" > "`. For example `"Technical Issue > Compute > Compute Engine"`. Classification IDs returned by `caseClassifications.search` are guaranteed to be valid for at least 6 months. If a
-         * given classification is deactiveated, it will immediately stop being returned. After 6 months, `case.create` requests using the classification ID will fail.
+         * `" > "`. For example `"Technical Issue > Compute > Compute Engine"`. Classification IDs returned by `caseClassifications.search` are guaranteed to be valid for at least six months. If a
+         * given classification is deactivated, it immediately stops being returned. After six months, `case.create` requests using the classification ID will fail. Here is an example of calling
+         * this endpoint using cURL: ```shell curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \
+         * 'https://cloudsupport.googleapis.com/v2/caseClassifications:search?query=display_name:"*Compute%20Engine*"' ```
          */
         await gapi.client.cloudsupport.caseClassifications.search({
             pageSize: 42,
             pageToken: "Test string",
             query: "Test string",
         });
-        /** Close the specified case. */
+        /**
+         * Close the specified case. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/43595344" curl \ --request POST \ --header "Authorization:
+         * Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case:close" ```
+         */
         await gapi.client.cloudsupport.cases.close({
             name: "Test string",
         }, {
         });
         /**
          * Create a new case and associate it with the given Google Cloud Resource. The case object must have the following fields set: `display_name`, `description`, `classification`, and
-         * `priority`.
+         * `priority`. Here is an example of calling this endpoint using cURL: ```shell parent="projects/some-project" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth
+         * print-access-token)" \ --header 'Content-Type: application/json' \ --data '{ "display_name": "Test case created by me.", "description": "a random test case, feel free to close",
+         * "classification": { "id": "100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8" }, "time_zone": "-07:00",
+         * "subscriber_email_addresses": [ "foo@domain.com", "bar@domain.com" ], "testCase": true, "priority": "P3" }' \ "https://cloudsupport.googleapis.com/v2/$parent/cases" ```
          */
         await gapi.client.cloudsupport.cases.create({
             parent: "Test string",
@@ -77,8 +85,11 @@ gapi.load('client', async () => {
             updateTime: "Test string",
         });
         /**
-         * Escalate a case. Escalating a case will initiate the Google Cloud Support escalation management process. This operation is only available to certain Customer Care tiers. Go to
-         * https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations.
+         * Escalate a case. Escalating a case initiates the Google Cloud Support escalation management process. This operation is only available to certain Customer Care support services. Go to
+         * https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which support services let you perform escalations. Here is an example of
+         * calling this endpoint using cURL: ```shell case="projects/some-project/cases/43595344" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \
+         * --header "Content-Type: application/json" \ --data '{ "escalation": { "reason": "BUSINESS_IMPACT", "justification": "This is a test escalation." } }' \
+         * "https://cloudsupport.googleapis.com/v2/$case:escalate" ```
          */
         await gapi.client.cloudsupport.cases.escalate({
             name: "Test string",
@@ -88,13 +99,17 @@ gapi.load('client', async () => {
                 reason: "Test string",
             },
         });
-        /** Retrieve the specified case. */
+        /**
+         * Retrieve the specified case. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/16033687" curl \ --header "Authorization: Bearer $(gcloud
+         * auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case" ```
+         */
         await gapi.client.cloudsupport.cases.get({
             name: "Test string",
         });
         /**
-         * Retrieve all cases under the specified parent. Note: Listing cases under an Organization returns only the cases directly parented by that organization. To retrieve all cases under an
-         * organization, including cases parented by projects under that organization, use `cases.search`.
+         * Retrieve all cases under the specified parent. Note: Listing cases under an organization returns only the cases directly parented by that organization. To retrieve all cases under an
+         * organization, including cases parented by projects under that organization, use `cases.search`. Here is an example of calling this endpoint using cURL: ```shell
+         * parent="projects/some-project" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$parent/cases" ```
          */
         await gapi.client.cloudsupport.cases.list({
             filter: "Test string",
@@ -102,7 +117,11 @@ gapi.load('client', async () => {
             pageToken: "Test string",
             parent: "Test string",
         });
-        /** Update the specified case. Only a subset of fields can be updated. */
+        /**
+         * Update the specified case. Only a subset of fields can be updated. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/43595344" curl \
+         * --request PATCH \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ --data '{ "priority": "P1" }' \
+         * "https://cloudsupport.googleapis.com/v2/$case?updateMask=priority" ```
+         */
         await gapi.client.cloudsupport.cases.patch({
             name: "Test string",
             updateMask: "Test string",
@@ -132,20 +151,30 @@ gapi.load('client', async () => {
             timeZone: "Test string",
             updateTime: "Test string",
         });
-        /** Search cases using the specified query. */
+        /**
+         * Search cases using the specified query. Here is an example of calling this endpoint using cURL: ```shell parent="projects/some-project" curl \ --header "Authorization: Bearer $(gcloud
+         * auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$parent/cases:search" ```
+         */
         await gapi.client.cloudsupport.cases.search({
             pageSize: 42,
             pageToken: "Test string",
             parent: "Test string",
             query: "Test string",
         });
-        /** Retrieve all attachments associated with a support case. */
+        /**
+         * Retrieve all attachments associated with a support case. Here is an example of calling this endpoint using cURL: ```shell case="projects/some-project/cases/23598314" curl \ --header
+         * "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/attachments" ```
+         */
         await gapi.client.cloudsupport.cases.attachments.list({
             pageSize: 42,
             pageToken: "Test string",
             parent: "Test string",
         });
-        /** Add a new comment to the specified Case. The comment object must have the following fields set: body. */
+        /**
+         * Add a new comment to the specified Case. The comment object must have the following fields set: body. Here is an example of calling this endpoint using cURL: ```shell
+         * case="projects/some-project/cases/43591344" curl \ --request POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header 'Content-Type: application/json' \
+         * --data '{ "body": "This is a test comment." }' \ "https://cloudsupport.googleapis.com/v2/$case/comments" ```
+         */
         await gapi.client.cloudsupport.cases.comments.create({
             parent: "Test string",
         }, {
@@ -159,17 +188,28 @@ gapi.load('client', async () => {
             name: "Test string",
             plainTextBody: "Test string",
         });
-        /** Retrieve all Comments associated with the Case object. */
+        /**
+         * Retrieve all comments associated with the Case object. Here is an example of calling this endpoint using cURL: ```shell case="projects/cloud-support-qa-premium/cases/43595344" curl \
+         * --header "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://cloudsupport.googleapis.com/v2/$case/comments" ```
+         */
         await gapi.client.cloudsupport.cases.comments.list({
             pageSize: 42,
             pageToken: "Test string",
             parent: "Test string",
         });
-        /** Download a file attachment on a case. Note: HTTP requests must append "?alt=media" to the URL. */
+        /**
+         * Download a file attachment on a case. Note: HTTP requests must append "?alt=media" to the URL. Here is an example of calling this endpoint using cURL: ```shell
+         * name="projects/some-project/cases/43594844/attachments/0674M00000WijAnZAJ" curl \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \
+         * "https://cloudsupport.googleapis.com/v2/$name:download?alt=media" ```
+         */
         await gapi.client.cloudsupport.media.download({
             name: "Test string",
         });
-        /** Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename. */
+        /**
+         * Create a file attachment on a case or Cloud resource. The attachment object must have the following fields set: filename. Here is an example of calling this endpoint using cURL:
+         * ```shell echo "This text is in a file I'm uploading using CSAPI." \ > "./example_file.txt" case="projects/some-project/cases/43594844" curl \ --header "Authorization: Bearer $(gcloud
+         * auth print-access-token)" \ --data-binary @"./example_file.txt" \ "https://cloudsupport.googleapis.com/upload/v2beta/$case/attachments?attachment.filename=uploaded_via_curl.txt" ```
+         */
         await gapi.client.cloudsupport.media.upload({
             parent: "Test string",
         }, {