From e3480ba2aeb171729dbb1429d29317a1044f1611 Mon Sep 17 00:00:00 2001
From: Kavin <20838718+FireMasterK@users.noreply.github.com>
Date: Fri, 2 Jun 2023 22:54:26 +0100
Subject: [PATCH] Update the JavaDoc for the rate-limiting issue.
---
.../youtube/extractors/YoutubeStreamExtractor.java | 13 ++++++++++++-
1 file changed, 12 insertions(+), 1 deletion(-)
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeStreamExtractor.java b/extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeStreamExtractor.java
index 86ae8533f..03a879493 100644
--- a/extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeStreamExtractor.java
+++ b/extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeStreamExtractor.java
@@ -1079,12 +1079,23 @@ public class YoutubeStreamExtractor extends StreamExtractor {
* Checks whether an additional player response is not valid.
*
*
- * If YouTube detect that requests come from a third party client, they may replace the real
+ * If YouTube detects that requests come from a third party client, they may replace the real
* player response by another one of a video saying that this content is not available on this
* app and to watch it on the latest version of YouTube.
*
*
*
+ * YouTube may also sometimes for currently unknown reasons rate-limit an IP, and replace the real one
+ * by a player response with a video that says that the video is unavailable.
+ *
+ *
+ *
+ * This behaviour has been observed in on the {@code ANDROID} and {@code WEB} clients, see
+ *
+ * https://github.com/TeamPiped/Piped/issues/2487.
+ *
+ *
+ *
* We can detect this by checking whether the video ID of the player response returned is the
* same as the one requested by the extractor.
*