feat(youtube): update the API

#### youtube:v3

The following keys were added:
- resources.activities.methods.list.parameters.mine.deprecated
- resources.commentThreads.methods.list.parameters.postId.description
- resources.commentThreads.methods.list.parameters.postId.location
- resources.commentThreads.methods.list.parameters.postId.type
- schemas.CommentSnippet.properties.postId.description
- schemas.CommentSnippet.properties.postId.type
- schemas.CommentSnippetAuthorChannelId.properties.value.description
- schemas.CommentThreadSnippet.properties.postId.description
- schemas.CommentThreadSnippet.properties.postId.type

The following keys were changed:
- schemas.CommentSnippet.properties.channelId.description
- schemas.CommentSnippet.properties.parentId.description
- schemas.CommentSnippetAuthorChannelId.description
- schemas.CommentThreadSnippet.properties.channelId.description
- schemas.CommentThreadSnippet.properties.videoId.description

Author: yoshi-automation

discovery/youtube-v3.json

@@ -185,6 +185,7 @@
               "type": "integer"
             },
             "mine": {
+              "deprecated": true,
               "location": "query",
               "type": "boolean"
             },
@@ -938,6 +939,11 @@
               "required": true,
               "type": "string"
             },
+            "postId": {
+              "description": "Returns the comment threads of the specified post.",
+              "location": "query",
+              "type": "string"
+            },
             "searchTerms": {
               "description": "Limits the returned comment threads to those matching the specified key words. Not compatible with the 'id' filter.",
               "location": "query",
@@ -4100,7 +4106,7 @@
       }
     }
   },
-  "revision": "20250224",
+  "revision": "20250422",
   "rootUrl": "https://youtube.googleapis.com/",
   "schemas": {
     "AbuseReport": {
@@ -5763,7 +5769,7 @@
           "type": "boolean"
         },
         "channelId": {
-          "description": "The id of the corresponding YouTube channel. In case of a channel comment this is the channel the comment refers to. In case of a video comment it's the video's channel.",
+          "description": "The id of the corresponding YouTube channel. In case of a channel comment this is the channel the comment refers to. In case of a video or post comment it's the video/post's channel.",
           "type": "string"
         },
         "likeCount": {
@@ -5788,7 +5794,11 @@
           "type": "string"
         },
         "parentId": {
-          "description": "The unique id of the parent comment, only set for replies.",
+          "description": "The unique id of the top-level comment, only set for replies.",
+          "type": "string"
+        },
+        "postId": {
+          "description": "The ID of the post the comment refers to, if any.",
           "type": "string"
         },
         "publishedAt": {
@@ -5831,10 +5841,11 @@
       "type": "object"
     },
     "CommentSnippetAuthorChannelId": {
-      "description": "The id of the author's YouTube channel, if any.",
+      "description": "Contains the id of the author's YouTube channel, if any.",
       "id": "CommentSnippetAuthorChannelId",
       "properties": {
         "value": {
+          "description": "The id of the author's YouTube channel.",
           "type": "string"
         }
       },
@@ -5935,13 +5946,17 @@
           "type": "boolean"
         },
         "channelId": {
-          "description": "The YouTube channel the comments in the thread refer to or the channel with the video the comments refer to. If video_id isn't set the comments refer to the channel itself.",
+          "description": "The YouTube channel the comments in the thread refer to or the channel with the video the comments refer to. If neither video_id nor post_id is set the comments refer to the channel itself.",
           "type": "string"
         },
         "isPublic": {
           "description": "Whether the thread (and therefore all its comments) is visible to all YouTube users.",
           "type": "boolean"
         },
+        "postId": {
+          "description": "The ID of the post the comments refer to, if any.",
+          "type": "string"
+        },
         "topLevelComment": {
           "$ref": "Comment",
           "description": "The top level comment of this thread."
@@ -5952,7 +5967,7 @@
           "type": "integer"
         },
         "videoId": {
-          "description": "The ID of the video the comments refer to, if any. No video_id implies a channel discussion comment.",
+          "description": "The ID of the video the comments refer to, if any.",
           "type": "string"
         }
       },

src/apis/youtube/v3.ts

@@ -1261,7 +1261,7 @@ export namespace youtube_v3 {
      */
     canRate?: boolean | null;
     /**
-     * The id of the corresponding YouTube channel. In case of a channel comment this is the channel the comment refers to. In case of a video comment it's the video's channel.
+     * The id of the corresponding YouTube channel. In case of a channel comment this is the channel the comment refers to. In case of a video or post comment it's the video/post's channel.
      */
     channelId?: string | null;
     /**
@@ -1273,9 +1273,13 @@ export namespace youtube_v3 {
      */
     moderationStatus?: string | null;
     /**
-     * The unique id of the parent comment, only set for replies.
+     * The unique id of the top-level comment, only set for replies.
      */
     parentId?: string | null;
+    /**
+     * The ID of the post the comment refers to, if any.
+     */
+    postId?: string | null;
     /**
      * The date and time when the comment was originally published.
      */
@@ -1302,9 +1306,12 @@ export namespace youtube_v3 {
     viewerRating?: string | null;
   }
   /**
-   * The id of the author's YouTube channel, if any.
+   * Contains the id of the author's YouTube channel, if any.
    */
   export interface Schema$CommentSnippetAuthorChannelId {
+    /**
+     * The id of the author's YouTube channel.
+     */
     value?: string | null;
   }
   /**
@@ -1381,13 +1388,17 @@ export namespace youtube_v3 {
      */
     canReply?: boolean | null;
     /**
-     * The YouTube channel the comments in the thread refer to or the channel with the video the comments refer to. If video_id isn't set the comments refer to the channel itself.
+     * The YouTube channel the comments in the thread refer to or the channel with the video the comments refer to. If neither video_id nor post_id is set the comments refer to the channel itself.
      */
     channelId?: string | null;
     /**
      * Whether the thread (and therefore all its comments) is visible to all YouTube users.
      */
     isPublic?: boolean | null;
+    /**
+     * The ID of the post the comments refer to, if any.
+     */
+    postId?: string | null;
     /**
      * The top level comment of this thread.
      */
@@ -1397,7 +1408,7 @@ export namespace youtube_v3 {
      */
     totalReplyCount?: number | null;
     /**
-     * The ID of the video the comments refer to, if any. No video_id implies a channel discussion comment.
+     * The ID of the video the comments refer to, if any.
      */
     videoId?: string | null;
   }
@@ -7212,6 +7223,10 @@ export namespace youtube_v3 {
      * The *part* parameter specifies a comma-separated list of one or more commentThread resource properties that the API response will include.
      */
     part?: string[];
+    /**
+     * Returns the comment threads of the specified post.
+     */
+    postId?: string;
     /**
      * Limits the returned comment threads to those matching the specified key words. Not compatible with the 'id' filter.
      */