o jEi|)@sddlmZddlmZmZmZddlmZddlm Z ddl m Z m Z m Z GdddeZGd d d eZGd d d eZGd ddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdd d eZGd!d"d"eZGd#d$d$eZGd%d&d&eZGd'd(d(eZGd)d*d*eZ Gd+d,d,eZ!d-S).)Path)IterableOptionalList) HTTPError) WATCH_URL) ProxyConfigGenericProxyConfigWebshareProxyConfigc@ eZdZdS)YouTubeTranscriptApiExceptionN__name__ __module__ __qualname__rr[/var/www/agentarbitrage/venv/lib/python3.10/site-packages/youtube_transcript_api/_errors.pyr r c@r ) CookieErrorNrrrrrrrrc"eZdZdeffdd ZZS)CookiePathInvalid cookie_pathctd|dS)Nz%Can't load the provided cookie file: super__init__selfr __class__rrrszCookiePathInvalid.__init__rrrrr __classcell__rrrrrrcr) CookieInvalidrcr)Nz7The cookies provided are not valid (may have expired): rrrrrrszCookieInvalid.__init__r!rrrrr$r#r$csdeZdZdZdZdZdZdZdeffdd Z d efd d Z e d efd d Z d efddZ ZS)CouldNotRetrieveTranscriptz8 Raised if a transcript could not be retrieved. z; Could not retrieve a transcript for the video {video_url}!z( This is most likely caused by: {cause}a If you are sure that the described cause is not responsible for this error and that a transcript should be retrievable, please create an issue at https://github.com/jdepoix/youtube-transcript-api/issues. Please add which version of youtube_transcript_api you are using and provide the information needed to replicate the error. Also make sure that there are no open issues which already describe your problem!video_idcs||_tdSN)r'rrrr'rrrr3sz#CouldNotRetrieveTranscript.__init__returncCs>|jjtj|jdd}|j}|r||jj|d|j7}|S)N)r') video_url)cause) ERROR_MESSAGEformatrr'r,CAUSE_MESSAGE_INTROGITHUB_REFERRAL)r error_messager,rrr_build_error_message7s z/CouldNotRetrieveTranscript._build_error_messagecCs|jSr() CAUSE_MESSAGErrrrr,Dsz CouldNotRetrieveTranscript.causecCs|Sr()r2r4rrr__str__Hsz"CouldNotRetrieveTranscript.__str__)rrr__doc__r-r/r3r0strrr2propertyr,r5r"rrrrr%"s  r%c@eZdZdZdS)YouTubeDataUnparsablezThe data required to fetch the transcript is not parsable. This should not happen, please open an issue (make sure to include the video ID)!Nrrrr3rrrrr:Lr:cs<eZdZdZdedeffdd ZedefddZZ S) YouTubeRequestFailedz#Request to YouTube failed: {reason}r' http_errorcst||_t|dSr()r7reasonrr)rr'r>rrrrVs zYouTubeRequestFailed.__init__r*cCs|jj|jdS)Nr?)r3r.r?r4rrrr,ZszYouTubeRequestFailed.cause) rrrr3r7rrr8r,r"rrrrr=Ss r=csFeZdZdZdZdedeedeeffdd Ze dd Z Z S) VideoUnplayablez:The video is unplayable for the following reason: {reason}z# Additional Details: {sub_reasons}r'r? sub_reasonsc||_||_t|dSr()r?rBrr)rr'r?rBrrrreszVideoUnplayable.__init__cCsT|jdurdn|j}|jr#ddd|jD}||jj|d}|jj|dS)NzNo reason specified! css|]}d|VqdS)z - Nr).0 sub_reasonrrr ns  z(VideoUnplayable.cause..)rBr@)r?rBjoinSUBREASON_MESSAGEr.r3)rr?rBrrrr,js zVideoUnplayable.cause) rrrr3rIr7rrrr8r,r"rrrrrAas "rAc@r9)VideoUnavailablez The video is no longer availableNr;rrrrrJwrJc@r9)InvalidVideoIdzYou provided an invalid video id. Make sure you are using the video id and NOT the url! Do NOT run: `YouTubeTranscriptApi().fetch("https://www.youtube.com/watch?v=1234")` Instead run: `YouTubeTranscriptApi().fetch("1234")`Nr;rrrrrL{r<rLcsdeZdZdZedZdZdZdeffdd Zde e d dfd d Z e d effd d Z ZS)RequestBlockedabYouTube is blocking requests from your IP. This usually is due to one of the following reasons: - You have done too many requests and your IP has been blocked by YouTube - You are doing requests from an IP belonging to a cloud provider (like AWS, Google Cloud Platform, Azure, etc.). Unfortunately, most IPs from cloud providers are blocked by YouTube. aFThere are two things you can do to work around this: 1. Use proxies to hide your IP address, as explained in the "Working around IP bans" section of the README (https://github.com/jdepoix/youtube-transcript-api?tab=readme-ov-file#working-around-ip-bans-requestblocked-or-ipblocked-exception). 2. (NOT RECOMMENDED) If you authenticate your requests using cookies, you will be able to continue doing requests for a while. However, YouTube will eventually permanently ban the account that you have used to authenticate with! So only do this if you don't mind your account being banned!aYouTube is blocking your requests, despite you using proxies. Keep in mind that a proxy is just a way to hide your real IP behind the IP of that proxy, but there is no guarantee that the IP of that proxy won't be blocked as well. The only truly reliable way to prevent IP blocks is rotating through a large pool of residential IPs, by using a provider like Webshare (https://www.webshare.io/?referral_code=w0xno53eb50g), which provides you with a pool of >30M residential IPs (make sure to purchase "Residential" proxies, NOT "Proxy Server" or "Static Residential"!). You will find more information on how to easily integrate Webshare here: https://github.com/jdepoix/youtube-transcript-api?tab=readme-ov-file#using-webshareaYouTube is blocking your requests, despite you using Webshare proxies. Please make sure that you have purchased "Residential" proxies and NOT "Proxy Server" or "Static Residential", as those won't work as reliably! The free tier also uses "Proxy Server" and will NOT work! The only reliable option is using "Residential" proxies (not "Static Residential"), as this allows you to rotate through a pool of over 30M IPs, which means you will always find an IP that hasn't been blocked by YouTube yet! You can support the development of this open source project by making your Webshare purchases through this affiliate link: https://www.webshare.io/?referral_code=w0xno53eb50g Thank you for your support! <3r'csd|_t|dSr() _proxy_configrrr)rrrrszRequestBlocked.__init__ proxy_configr*cCs ||_|Sr()rN)rrOrrrwith_proxy_configsz RequestBlocked.with_proxy_configcs,t|jtr |jSt|jtr|jStjSr() isinstancerNr !WITH_WEBSHARE_PROXY_CAUSE_MESSAGEr WITH_GENERIC_PROXY_CAUSE_MESSAGErr,r4rrrr,s  zRequestBlocked.cause)rrrBASE_CAUSE_MESSAGEr3rSrRr7rrr rPr8r,r"rrrrrMs"  rMc@seZdZejdZdS) IpBlockedzWays to work around this are explained in the "Working around IP bans" section of the README (https://github.com/jdepoix/youtube-transcript-api?tab=readme-ov-file#working-around-ip-bans-requestblocked-or-ipblocked-exception). N)rrrrMrTr3rrrrrUs rUc@r9)TranscriptsDisabledz%Subtitles are disabled for this videoNr;rrrrrVrKrVc@r9) AgeRestrictedaSThis video is age-restricted. Therefore, you are unable to retrieve transcripts for it without authenticating yourself. Unfortunately, Cookie Authentication is temporarily unsupported in youtube-transcript-api, as recent changes in YouTube's API broke the previous implementation. I will do my best to re-implement it as soon as possible.Nr;rrrrrWs rWc@r9)NotTranslatablez*The requested language is not translatableNr;rrrrrXrKrXc@r9)TranslationLanguageNotAvailablez3The requested translation language is not availableNr;rrrrrYrKrYc@r9)FailedToCreateConsentCookiez6Failed to automatically give consent to saving cookiesNr;rrrrrZrKrZcsDeZdZdZdedeeddffdd Zedefd d ZZ S) NoTranscriptFoundzpNo transcripts were found for any of the requested language codes: {requested_language_codes} {transcript_data}r'requested_language_codestranscript_dataTranscriptListcrCr()_requested_language_codes_transcript_datarr)rr'r\r]rrrrszNoTranscriptFound.__init__r*cCs|jj|jt|jdS)N)r\r])r3r.r_r7r`r4rrrr,szNoTranscriptFound.cause) rrrr3r7rrr8r,r"rrrrr[s r[c@r9)PoTokenRequiredzhThe requested video cannot be retrieved without a PO Token. If this happens, please open a GitHub issue!Nr;rrrrra r<raN)"pathlibrtypingrrrrequestsr _settingsrproxiesr r r Exceptionr rrr$r%r:r=rArJrLrMrUrVrWrXrYrZr[rarrrrs0    *F