fix(drive): update the API

#### drive:v2 The following keys were changed: - resources.files.methods.get.parameters.acknowledgeAbuse.description - resources.files.methods.watch.parameters.acknowledgeAbuse.description - schemas.File.properties.shortcutDetails.description - schemas.File.properties.shortcutDetails.properties.targetId.description - schemas.File.properties.thumbnailLink.description #### drive:v3 The following keys were changed: - resources.files.methods.get.parameters.acknowledgeAbuse.description - resources.files.methods.watch.parameters.acknowledgeAbuse.description - resources.revisions.methods.get.parameters.acknowledgeAbuse.description - schemas.File.properties.shortcutDetails.description - schemas.File.properties.shortcutDetails.properties.targetId.description - schemas.File.properties.thumbnailLink.description
googleapis · Aug 16, 2024 · 23195fa · 23195fa
1 parent c0965f3
commit 23195fa
Show file tree

Hide file tree

Showing 4 changed files with 22 additions and 22 deletions.
diff --git a/discovery/drive-v2.json b/discovery/drive-v2.json
@@ -1495,7 +1495,7 @@
           "parameters": {
             "acknowledgeAbuse": {
               "default": "false",
-              "description": "Whether the user is acknowledging the risk of downloading known malware or other abusive files.",
+              "description": "Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.",
               "location": "query",
               "type": "boolean"
             },
@@ -2380,7 +2380,7 @@
           "parameters": {
             "acknowledgeAbuse": {
               "default": "false",
-              "description": "Whether the user is acknowledging the risk of downloading known malware or other abusive files.",
+              "description": "Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.",
               "location": "query",
               "type": "boolean"
             },
@@ -3869,7 +3869,7 @@
       }
     }
   },
-  "revision": "20240522",
+  "revision": "20240730",
   "rootUrl": "https://www.googleapis.com/",
   "schemas": {
     "About": {
@@ -5614,10 +5614,10 @@
           "description": "Output only. User that shared the item with the current user, if available."
         },
         "shortcutDetails": {
-          "description": "Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`.",
+          "description": "Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`. Can only be set on `files.insert` requests.",
           "properties": {
             "targetId": {
-              "description": "The ID of the file that this shortcut points to.",
+              "description": "The ID of the file that this shortcut points to. Can only be set on `files.insert` requests.",
               "type": "string"
             },
             "targetMimeType": {
@@ -5659,7 +5659,7 @@
           "type": "object"
         },
         "thumbnailLink": {
-          "description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.",
+          "description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Not intended for direct usage on web applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS), consider using a proxy server. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.",
           "type": "string"
         },
         "thumbnailVersion": {

diff --git a/discovery/drive-v3.json b/discovery/drive-v3.json
@@ -1253,7 +1253,7 @@
           "parameters": {
             "acknowledgeAbuse": {
               "default": "false",
-              "description": "Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.",
+              "description": "Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.",
               "location": "query",
               "type": "boolean"
             },
@@ -1612,7 +1612,7 @@
           "parameters": {
             "acknowledgeAbuse": {
               "default": "false",
-              "description": "Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.",
+              "description": "Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.",
               "location": "query",
               "type": "boolean"
             },
@@ -2247,7 +2247,7 @@
           "parameters": {
             "acknowledgeAbuse": {
               "default": "false",
-              "description": "Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.",
+              "description": "Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.",
               "location": "query",
               "type": "boolean"
             },
@@ -2523,7 +2523,7 @@
       }
     }
   },
-  "revision": "20240521",
+  "revision": "20240730",
   "rootUrl": "https://www.googleapis.com/",
   "schemas": {
     "About": {
@@ -3851,10 +3851,10 @@
           "description": "Output only. The user who shared the file with the requesting user, if applicable."
         },
         "shortcutDetails": {
-          "description": "Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`.",
+          "description": "Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`. Can only be set on `files.create` requests.",
           "properties": {
             "targetId": {
-              "description": "The ID of the file that this shortcut points to.",
+              "description": "The ID of the file that this shortcut points to. Can only be set on `files.create` requests.",
               "type": "string"
             },
             "targetMimeType": {
@@ -3890,7 +3890,7 @@
           "type": "string"
         },
         "thumbnailLink": {
-          "description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.",
+          "description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Not intended for direct usage on web applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) policies, consider using a proxy server. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.",
           "type": "string"
         },
         "thumbnailVersion": {

diff --git a/src/apis/drive/v2.ts b/src/apis/drive/v2.ts
@@ -1206,7 +1206,7 @@ export namespace drive_v2 {
      */
     sharingUser?: Schema$User;
     /**
-     * Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`.
+     * Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`. Can only be set on `files.insert` requests.
      */
     shortcutDetails?: {
       targetId?: string;
@@ -1226,7 +1226,7 @@ export namespace drive_v2 {
      */
     thumbnail?: {image?: string; mimeType?: string} | null;
     /**
-     * Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.
+     * Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Not intended for direct usage on web applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS), consider using a proxy server. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.
      */
     thumbnailLink?: string | null;
     /**
@@ -6124,7 +6124,7 @@ export namespace drive_v2 {
   }
   export interface Params$Resource$Files$Get extends StandardParameters {
     /**
-     * Whether the user is acknowledging the risk of downloading known malware or other abusive files.
+     * Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.
      */
     acknowledgeAbuse?: boolean;
     /**
@@ -6575,7 +6575,7 @@ export namespace drive_v2 {
   }
   export interface Params$Resource$Files$Watch extends StandardParameters {
     /**
-     * Whether the user is acknowledging the risk of downloading known malware or other abusive files.
+     * Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.
      */
     acknowledgeAbuse?: boolean;
     /**

diff --git a/src/apis/drive/v3.ts b/src/apis/drive/v3.ts
@@ -923,7 +923,7 @@ export namespace drive_v3 {
      */
     sharingUser?: Schema$User;
     /**
-     * Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`.
+     * Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`. Can only be set on `files.create` requests.
      */
     shortcutDetails?: {
       targetId?: string;
@@ -947,7 +947,7 @@ export namespace drive_v3 {
      */
     teamDriveId?: string | null;
     /**
-     * Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.
+     * Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Not intended for direct usage on web applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) policies, consider using a proxy server. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.
      */
     thumbnailLink?: string | null;
     /**
@@ -4778,7 +4778,7 @@ export namespace drive_v3 {
   }
   export interface Params$Resource$Files$Get extends StandardParameters {
     /**
-     * Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.
+     * Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.
      */
     acknowledgeAbuse?: boolean;
     /**
@@ -4958,7 +4958,7 @@ export namespace drive_v3 {
   }
   export interface Params$Resource$Files$Watch extends StandardParameters {
     /**
-     * Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.
+     * Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.
      */
     acknowledgeAbuse?: boolean;
     /**
@@ -6473,7 +6473,7 @@ export namespace drive_v3 {
   }
   export interface Params$Resource$Revisions$Get extends StandardParameters {
     /**
-     * Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.
+     * Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.
      */
     acknowledgeAbuse?: boolean;
     /**