chore(release): 0.5.0 [skip ci]

# [0.5.0](v0.4.5...v0.5.0) (2025-01-22) ### Features * Support `playlistItems.delete` ([8bc6700](8bc6700))
suzuki3jp · Jan 22, 2025 · 18154d0 · 18154d0
1 parent d010207
commit 18154d0
Show file tree

Hide file tree

Showing 21 changed files with 149 additions and 72 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,10 @@
+# [0.5.0](https://github.com/suzuki3jp/youtubes.js/compare/v0.4.5...v0.5.0) (2025-01-22)
+
+
+### Features
+
+* Support `playlistItems.delete` ([8bc6700](https://github.com/suzuki3jp/youtubes.js/commit/8bc670063b629caab5e9c63ccd08e8ee0d330ce5))
+
 ## [0.4.5](https://github.com/suzuki3jp/youtubes.js/compare/v0.4.4...v0.4.5) (2025-01-21)
 
 ## [0.4.4](https://github.com/suzuki3jp/youtubes.js/compare/v0.4.3...v0.4.4) (2025-01-21)

diff --git a/docs/api/youtubes.js.likelybugerror.md b/docs/api/youtubes.js.likelybugerror.md
@@ -6,7 +6,7 @@
 
 Represents an error that is likely a bug in the library.
 
-If you encounter this error, please report the issue on \[GitHub Issue\](https://github.com/suzuki3jp/youtubes.js/issues/new).
+If you encounter this error, please report the issue on [GitHub Issue](https://github.com/suzuki3jp/youtubes.js/issues/new)<!-- -->.
 
 **Signature:**
 

diff --git a/docs/api/youtubes.js.md b/docs/api/youtubes.js.md
@@ -37,7 +37,7 @@ The main class for interacting with the YouTube Data API.
 
 Represents an error that is likely a bug in the library.
 
-If you encounter this error, please report the issue on \[GitHub Issue\](https://github.com/suzuki3jp/youtubes.js/issues/new).
+If you encounter this error, please report the issue on [GitHub Issue](https://github.com/suzuki3jp/youtubes.js/issues/new)<!-- -->.
 
 
 </td></tr>

diff --git a/docs/api/youtubes.js.pagination.all.md b/docs/api/youtubes.js.pagination.all.md
@@ -4,7 +4,7 @@
 
 ## Pagination.all() method
 
-Fetches all pages data. - \*\*NOTE\*\*: This method may consume unnecessary quotas, so be careful when using it in actual applications. - We strongly recommend fetching the next page based on user actions (e.g., scrolling).
+Fetches all pages data.
 
 **Signature:**
 
@@ -17,6 +17,10 @@ Promise&lt;Result&lt;T\[\], [YouTubesJsErrors](./youtubes.js.youtubesjserrors.md
 
 All pages data in an array. If several items are in a page, this method will return a 2D array. Use `flat()` to convert it to a 1D array.
 
+## Remarks
+
+- This method may consume unnecessary quotas, so be careful when using it in actual applications. - We strongly recommend fetching the next page based on user actions (e.g., scrolling).
+
 ## Example
 
 

diff --git a/docs/api/youtubes.js.pagination.md b/docs/api/youtubes.js.pagination.md
@@ -122,7 +122,7 @@ number
 
 </td><td>
 
-The total number of results in the result set. \*\*NOTE\*\*: This number may be larger than the number of actual retrievable results. The YouTube Data API may not return some playlists (for example, the "Liked videos" playlist). However, the totalResults count may include them.
+The total number of results in the result set.
 
 
 </td></tr>
@@ -156,7 +156,7 @@ Description
 
 </td><td>
 
-Fetches all pages data. - \*\*NOTE\*\*: This method may consume unnecessary quotas, so be careful when using it in actual applications. - We strongly recommend fetching the next page based on user actions (e.g., scrolling).
+Fetches all pages data.
 
 
 </td></tr>
@@ -170,7 +170,7 @@ Fetches all pages data. - \*\*NOTE\*\*: This method may consume unnecessary quot
 
 </td><td>
 
-Fetches the next page. - \*\*NOTE\*\*: This method will use the same quotas as the original request. - Normally, GET requests use a quota of 1 unit, while other methods use 50 units. - However, some heavy methods use more than 50 units. - See more details on the [YouTube Data API reference](https://developers.google.com/youtube/v3/determine_quota_cost)
+Fetches the next page.
 
 
 </td></tr>
@@ -184,7 +184,7 @@ Fetches the next page. - \*\*NOTE\*\*: This method will use the same quotas as t
 
 </td><td>
 
-Fetches the previous page. - \*\*NOTE\*\*: This method will use the same quotas as the original request. - Normally, GET requests use a quota of 1 unit, while other methods use 50 units. - However, some heavy methods use more than 50 units. - See more details on the [YouTube Data API reference](https://developers.google.com/youtube/v3/determine_quota_cost)
+Fetches the previous page.
 
 
 </td></tr>

diff --git a/docs/api/youtubes.js.pagination.next.md b/docs/api/youtubes.js.pagination.next.md
@@ -4,7 +4,7 @@
 
 ## Pagination.next() method
 
-Fetches the next page. - \*\*NOTE\*\*: This method will use the same quotas as the original request. - Normally, GET requests use a quota of 1 unit, while other methods use 50 units. - However, some heavy methods use more than 50 units. - See more details on the [YouTube Data API reference](https://developers.google.com/youtube/v3/determine_quota_cost)
+Fetches the next page.
 
 **Signature:**
 
@@ -17,6 +17,10 @@ Promise&lt;Result&lt;[Pagination](./youtubes.js.pagination.md)<!-- -->&lt;T&gt;,
 
 The next page. If there is no next page, returns `null`<!-- -->.
 
+## Remarks
+
+- This method will use the same quotas as the original request. - Normally, GET requests use a quota of 1 unit, while other methods use 50 units. - However, some heavy methods use more than 50 units. - See more details on the [YouTube Data API reference](https://developers.google.com/youtube/v3/determine_quota_cost)
+
 ## Example
 
 

diff --git a/docs/api/youtubes.js.pagination.prev.md b/docs/api/youtubes.js.pagination.prev.md
@@ -4,7 +4,7 @@
 
 ## Pagination.prev() method
 
-Fetches the previous page. - \*\*NOTE\*\*: This method will use the same quotas as the original request. - Normally, GET requests use a quota of 1 unit, while other methods use 50 units. - However, some heavy methods use more than 50 units. - See more details on the [YouTube Data API reference](https://developers.google.com/youtube/v3/determine_quota_cost)
+Fetches the previous page.
 
 **Signature:**
 
@@ -17,6 +17,10 @@ Promise&lt;Result&lt;[Pagination](./youtubes.js.pagination.md)<!-- -->&lt;T&gt;,
 
 The previous page. If there is no previous page, returns `null`<!-- -->.
 
+## Remarks
+
+- This method will use the same quotas as the original request. - Normally, GET requests use a quota of 1 unit, while other methods use 50 units. - However, some heavy methods use more than 50 units. - See more details on the [YouTube Data API reference](https://developers.google.com/youtube/v3/determine_quota_cost)
+
 ## Example
 
 

diff --git a/docs/api/youtubes.js.pagination.totalresults.md b/docs/api/youtubes.js.pagination.totalresults.md
@@ -4,10 +4,15 @@
 
 ## Pagination.totalResults property
 
-The total number of results in the result set. \*\*NOTE\*\*: This number may be larger than the number of actual retrievable results. The YouTube Data API may not return some playlists (for example, the "Liked videos" playlist). However, the totalResults count may include them.
+The total number of results in the result set.
 
 **Signature:**
 
 ```typescript
 totalResults: number;
 ```
+
+## Remarks
+
+This number may be larger than the number of actual retrievable results. The YouTube Data API may not return some playlists (for example, the "Liked videos" playlist). However, the totalResults count may include them.
+
diff --git a/docs/api/youtubes.js.playlistitemmanager.create.md b/docs/api/youtubes.js.playlistitemmanager.create.md
@@ -6,8 +6,6 @@
 
 Adds a item to a playlist.
 
-- The operation uses 50 quota units.
-
 **Signature:**
 
 ```typescript
@@ -55,3 +53,7 @@ Promise&lt;Result&lt;[PlaylistItem](./youtubes.js.playlistitem.md)<!-- -->, [You
 
 - The created playlist item.
 
+## Remarks
+
+The operation uses 50 quota units.
+
diff --git a/docs/api/youtubes.js.playlistitemmanager.deletebyid.md b/docs/api/youtubes.js.playlistitemmanager.deletebyid.md
@@ -0,0 +1,53 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [youtubes.js](./youtubes.js.md) &gt; [PlaylistItemManager](./youtubes.js.playlistitemmanager.md) &gt; [deleteById](./youtubes.js.playlistitemmanager.deletebyid.md)
+
+## PlaylistItemManager.deleteById() method
+
+Deletes a playlist item by its ID.
+
+**Signature:**
+
+```typescript
+deleteById(id: string): Promise<Result<undefined, YouTubesJsErrors>>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+id
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+The ID of the playlist item to delete.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+Promise&lt;Result&lt;undefined, [YouTubesJsErrors](./youtubes.js.youtubesjserrors.md)<!-- -->&gt;&gt;
+
diff --git a/docs/api/youtubes.js.playlistitemmanager.getbyplaylistid.md b/docs/api/youtubes.js.playlistitemmanager.getbyplaylistid.md
@@ -6,10 +6,6 @@
 
 Retrieves a list of playlist items by a playlist ID.
 
-- The operation uses 1 quota unit.
-
-[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlistItems/list)
-
 **Signature:**
 
 ```typescript
@@ -72,3 +68,9 @@ _(Optional)_ The page token to use for pagination.
 Promise&lt;Result&lt;[Pagination](./youtubes.js.pagination.md)<!-- -->&lt;[PlaylistItem](./youtubes.js.playlistitem.md)<!-- -->\[\]&gt;, [YouTubesJsErrors](./youtubes.js.youtubesjserrors.md)<!-- -->&gt;&gt;
 
 
+## Remarks
+
+The operation uses 1 quota unit.
+
+[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlistItems/list)
+
diff --git a/docs/api/youtubes.js.playlistitemmanager.md b/docs/api/youtubes.js.playlistitemmanager.md
@@ -78,7 +78,19 @@ Description
 
 Adds a item to a playlist.
 
-- The operation uses 50 quota units.
+
+</td></tr>
+<tr><td>
+
+[deleteById(id)](./youtubes.js.playlistitemmanager.deletebyid.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Deletes a playlist item by its ID.
 
 
 </td></tr>
@@ -94,10 +106,6 @@ Adds a item to a playlist.
 
 Retrieves a list of playlist items by a playlist ID.
 
-- The operation uses 1 quota unit.
-
-[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlistItems/list)
-
 
 </td></tr>
 </tbody></table>
diff --git a/docs/api/youtubes.js.playlistmanager.create.md b/docs/api/youtubes.js.playlistmanager.create.md
@@ -6,10 +6,6 @@
 
 Creates a playlist.
 
-- This operation uses 50 quota units. - There is a limit of approximately 10 playlists per day for creation. - For more details, see the issue: https://issuetracker.google.com/issues/255216949
-
-[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlists/insert)
-
 **Signature:**
 
 ```typescript
@@ -55,3 +51,9 @@ Options for creating a playlist.
 
 Promise&lt;Result&lt;[Playlist](./youtubes.js.playlist.md)<!-- -->, [YouTubesJsErrors](./youtubes.js.youtubesjserrors.md)<!-- -->&gt;&gt;
 
+## Remarks
+
+- This operation uses 50 quota units. - There is a limit of approximately 10 playlists per day for creation. - For more details, see the issue: https://issuetracker.google.com/issues/255216949
+
+[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlists/insert)
+
diff --git a/docs/api/youtubes.js.playlistmanager.deletebyid.md b/docs/api/youtubes.js.playlistmanager.deletebyid.md
@@ -6,10 +6,6 @@
 
 Deletes a playlist by its ID.
 
-- This operation uses 50 quota units.
-
-[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlists/delete)
-
 **Signature:**
 
 ```typescript
@@ -55,3 +51,9 @@ The ID of the playlist.
 
 Promise&lt;void&gt;
 
+## Remarks
+
+This operation uses 50 quota units.
+
+[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlists/delete)
+
diff --git a/docs/api/youtubes.js.playlistmanager.getbychannelid.md b/docs/api/youtubes.js.playlistmanager.getbychannelid.md
@@ -6,10 +6,6 @@
 
 Fetches the playlists of a channel by its ID.
 
-- This operation uses 1 quota unit. - Retrieves all playlists when given an authenticated user's channel ID. Otherwise, only public playlists are accessible.
-
-[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlists/list)
-
 **Signature:**
 
 ```typescript
@@ -71,6 +67,12 @@ _(Optional)_ The token for pagination.
 
 Promise&lt;Result&lt;[Pagination](./youtubes.js.pagination.md)<!-- -->&lt;[Playlist](./youtubes.js.playlist.md)<!-- -->\[\]&gt;, [YouTubesJsErrors](./youtubes.js.youtubesjserrors.md)<!-- -->&gt;&gt;
 
+## Remarks
+
+- This operation uses 1 quota unit. - Retrieves all playlists when given an authenticated user's channel ID. Otherwise, only public playlists are accessible.
+
+[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlists/list)
+
 ## Example
 
 

diff --git a/docs/api/youtubes.js.playlistmanager.getbyids.md b/docs/api/youtubes.js.playlistmanager.getbyids.md
@@ -6,10 +6,6 @@
 
 Fetches a playlist by its ID.
 
-- This operation uses 1 quota unit. - Note: The YouTube API returns empty data instead of an error when a playlist with the specified ID is not found.
-
-[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlists/list)
-
 **Signature:**
 
 ```typescript
@@ -71,6 +67,12 @@ _(Optional)_ The token for pagination.
 
 Promise&lt;Result&lt;[Pagination](./youtubes.js.pagination.md)<!-- -->&lt;[Playlist](./youtubes.js.playlist.md)<!-- -->\[\]&gt;, [YouTubesJsErrors](./youtubes.js.youtubesjserrors.md)<!-- -->&gt;&gt;
 
+## Remarks
+
+- This operation uses 1 quota unit. - Note: The YouTube API returns empty data instead of an error when a playlist with the specified ID is not found.
+
+[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlists/list)
+
 ## Example
 
 

diff --git a/docs/api/youtubes.js.playlistmanager.getmine.md b/docs/api/youtubes.js.playlistmanager.getmine.md
@@ -6,10 +6,6 @@
 
 Fetches the playlists owned by the authenticated user.
 
-- This operation uses 1 quota unit.
-
-[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlists/list)
-
 **Signature:**
 
 ```typescript
@@ -55,6 +51,12 @@ _(Optional)_ The token for pagination.
 
 Promise&lt;Result&lt;[Pagination](./youtubes.js.pagination.md)<!-- -->&lt;[Playlist](./youtubes.js.playlist.md)<!-- -->\[\]&gt;, [YouTubesJsErrors](./youtubes.js.youtubesjserrors.md)<!-- -->&gt;&gt;
 
+## Remarks
+
+This operation uses 1 quota unit.
+
+[YouTube Data API Reference](https://developers.google.com/youtube/v3/docs/playlists/list)
+
 ## Example