+ TŎitZ^RIHt^RIHt^RIHtHtHtHt^RI H t ^RI H t ^RI H t ^RIt^RIHt^RIt^RIt^RIt^RIt^R IHt^R IHt^R IHt!R R ]4t!RR]4t!RR]4t!RR4t !RR]4t!] R4t"Rt#R# ]d^RItL]i;i))FacebookSession) apiconfig)FacebookRequestErrorFacebookBadObjectError$FacebookUnavailablePropertyExceptionFacebookBadParameterError) api_utils)urls)contextmanagerN) http_client)collections_abc) ObjectParser) TypeCheckerc^a]tRt^+toRtR RltRtRtRtRt Rt R t R t R t R tVtR#)FacebookResponsez8Encapsulates an http response from Facebook's Graph API.Nc LWnW nT;'g/VnW@nR#)zInitializes the object's internal data. Args: body (optional): The response body as text. http_status (optional): The http status code. headers (optional): The http headers. call (optional): The original call that was made. N)_body _http_status_headers_call)selfbody http_statusheaderscalls&&&&&d/Users/ahmad/.openclaw/workspace/scripts/.venv/lib/python3.14/site-packages/facebook_business/api.py__init__FacebookResponse.__init__/s! ' 2  c VP#)zReturns the response body.)rrs&rrFacebookResponse.body<s zzrc \P!VP4# \\3dTPu#i;i)z1Returns the response body -- in json if possible.)jsonloadsr TypeError ValueErrorr!s&rr$FacebookResponse.json@s8 ::djj) ):& ::  s"AAc VP#)zReturn the response headers.rr!s&rrFacebookResponse.headersGs }}rc 8VPPR4#)z+Returns the ETag header value if it exists.ETag)rgetr!s&retagFacebookResponse.etagKs}}  ((rc VP#)z-Returns the http status code of the response.)rr!s&rstatusFacebookResponse.statusOs   rc HVP4p\V\P4'd RV9dR#\ V4'dRV9d VR,#RV9#VP \ P8XdR#VP \ P8XdR#R#)z6Returns boolean indicating if the call was successful.errorFsuccesszService UnavailableT) r$ isinstancer Mappingboolrr NOT_MODIFIEDOK)r json_bodys& r is_successFacebookResponse.is_successSsIIK i!8!8 9 9g>R )__I% ++( 9 9   +":": :   +.. 0rc ,VP4'*#)z.Returns boolean indicating if the call failed.)r=r!s&r is_failureFacebookResponse.is_failureks??$$$rc VP4'dD\RVPVP4VP 4VP 44#R#)zf Returns a FacebookRequestError (located in the exceptions module) with an appropriate debug message. zCall was not successfulN)r@rrr2rrr!s&rr5FacebookResponse.errorosH ??  ')     r)rrrr)NNNN)__name__ __module__ __qualname____firstlineno____doc__rrr$rr/r2r=r@r5__static_attributes____classdictcell__ __classdict__s@rrr+s:B )!0%rrca]tRt^toRt]P R,t]P R,tRt Rt Rt RR],/t R t R tRR ltR tR t]RR l4t]R4t]R4t]R4t]R4tRRltRtRtVtR #)FacebookAdsApiayEncapsulates session attributes and methods to make API calls. Attributes: SDK_VERSION (class): indicating sdk version. HTTP_METHOD_GET (class): HTTP GET method name. HTTP_METHOD_POST (class): HTTP POST method name HTTP_METHOD_DELETE (class): HTTP DELETE method name HTTP_DEFAULT_HEADERS (class): Default HTTP headers for requests made by this sdk. SDK_VERSION API_VERSIONGETPOSTDELETEz User-Agentzfbbizsdk-python-%sNc pWn^Vn^VnT;'g VPVnW0nR#)zInitializes the api instance. Args: session: FacebookSession object that contains a requests interface and attribute GRAPH (the Facebook GRAPH API URL). api_version: API version N)_session_num_requests_succeeded_num_requests_attemptedrP _api_version_enable_debug_logger)rsession api_versionenable_debug_loggers&&&&rrFacebookAdsApi.__init__s5 '($'($';;4+;+;$7!rc VP#)z&Returns the number of calls attempted.)rWr!s&rget_num_requests_attempted)FacebookAdsApi.get_num_requests_attempted+++rc VP#)z+Returns the number of calls that succeeded.)rVr!s&rget_num_requests_succeeded)FacebookAdsApi.get_num_requests_succeededrarc \WW6V4p V!WVR7p VPV 4V'dVPV4V 'd/^RIHp V'dV P 4V P 4V #))r\) CrashReporter)rset_default_apiset_default_account_idfacebook_business.crashreporterrf enableLoggingenable) clsapp_id app_secret access_token account_idr[proxiestimeoutdebug crash_logrZapirfs &&&&&&&&&& rinitFacebookAdsApi.initsf"&l")+'EB C   & &z 2  E++-  " rc WnR#)zSets the default api instance. When making calls to the api, objects will revert to using the default api if one is not specified when initializing the objects. Args: api_instance: The instance which to set as default. N _default_api)rl api_instances&&rrgFacebookAdsApi.set_default_apis (rc VP#)z!Returns the default api instance.ryrls&rget_default_apiFacebookAdsApi.get_default_apisrcj\V4pVPR4R8Xd \R4hWnR#)act_zeAccount ID provided in FacebookAdsApi.set_default_account_id expects a string that begins with 'act_'N)strfindr'_default_account_id)rlrps&&rrh%FacebookAdsApi.set_default_account_ids6_ ??6 "b (; #-rcVP#N)rr~s&rget_default_account_id%FacebookAdsApi.get_default_account_ids&&&rc V'g/pV'g/pV'g/pT;'g VPpV'd:\P!RV4'g\RVP,4hV;P ^, un\ V\P4'gPRPT;'gVPPVRP\\V4434pVP4pVP\ P"4V'd \%V4pVR 9dAVPP&P)VVVVVVPP*R7pM?VPP&P)VVVVVVPP*R7pVP,'d)^RIp \1V P3VP(44\5VP6VP8VP:RVRVR VR VR V/R 7p V P=4'dV P?4hV;P@^, un V #)aMakes an API call. Args: method: The HTTP method name (e.g. 'GET'). path: A tuple of path tokens or a full URL string. A tuple will be translated to a url as follows: graph_url/tuple[0]/tuple[1]... It will be assumed that if the path is not a string, it will be iterable. params (optional): A mapping of request parameters where a key is the parameter name and its value is a string or an object which can be JSON-encoded. headers (optional): A mapping of request headers where a key is the header name and its value is the header value. files (optional): An optional mapping of file names to binary open file objects. These files will be attached to the request. Returns: A FacebookResponse object containing the response body, headers, http status, and summary of the call that was made. Raises: FacebookResponse.error() if the request failed. zv[0-9]+\.[0-9]+z:Please provide the API version in the following format: %s/)paramsrfilesrr)datarrrrNmethodpathrrrrrrr)rQrS)!rXresearchrrPrWr7six string_typesjoinrUGRAPHmaprcopyupdaterNHTTP_DEFAULT_HEADERS_top_level_param_json_encoderequestsrequestrrrYcurlifyprintto_curlrtextr status_coder@r5rV) rrrrrr url_overrider[responser fb_responses &&&&&&&& rrFacebookAdsApi.calls>FGE!66T%6%6 ryy);[II(L""#  $$)$$ 0 0118833 3 3S$(D,,.~::; 1&9F & &}}--55 -- 6H}}--55 -- 6H  $ $ $  '//("2"23 4&$$ ,,&&7     ! ! # ###% % $$)$rc \VR7#)zR Returns a new FacebookAdsApiBatch, which when executed will go through this api. )ru)FacebookAdsApiBatchr!s&r new_batchFacebookAdsApi.new_batchUs #t,,r)rXrYrWrVrU)NF) NNNNNNNFT)NNNNN)rDrErFrGrHrads_api_configrOrPHTTP_METHOD_GETHTTP_METHOD_POSTHTTP_METHOD_DELETErrzrrr_rc classmethodrvrgrrhrrrrIrJrKs@rrNrNs**=9K**=9KO! *[8L 8,,8((  --''gR--rrNcNa]tRtRtoRtR RltRtR RltR RltRt R t Vt R#) ri]a Exposes methods to build a sequence of calls which can be executed with a single http request. Note: Individual exceptions won't be thrown for each call that fails. The success and failure callback functions corresponding to a call should handle its success or failure. NcWn.Vn.Vn.Vn.VnVeVPP V4VeVPP V4.VnR#r)_api_files_batch_success_callbacks_failure_callbacksappend _requests)rrur6failures&&&&rrFacebookAdsApiBatch.__init__gs`   "$"$    # # * *7 3    # # * *7 3rc,\VP4#r)lenrr!s&r__len__FacebookAdsApiBatch.__len__s4;;rc  \V\P4'gRPV4p MTp RVRV /p V'd\ V4pVP 4U U u.uF"wrV : R\ P!V 4: 2NK$ p p p VR8Xd-V R;;,RRPV 4,, uu&MRPV 4V R&V'd#R PVP44V R &V'd8.V R &VF,p/pWR &WN,VR &V R ,PV4K. VPPV 4VPPV4VPPV4VPPV4VPPV4V #uup p i)arAdds a call to the batch. Args: method: The HTTP method name (e.g. 'GET'). relative_path: A tuple of path tokens or a relative URL string. A tuple will be translated to a url as follows: //... It will be assumed that if the path is not a string, it will be iterable. params (optional): A mapping of request parameters where a key is the parameter name and its value is a string or an object which can be JSON-encoded. headers (optional): A mapping of request headers where a key is the header name and its value is the header value. files (optional): An optional mapping of file names to binary open file objects. These files will be attached to the request. success (optional): A callback function which will be called with the FacebookResponse of this call if the call succeeded. failure (optional): A callback function which will be called with the FacebookResponse of this call if the call failed. request (optional): The APIRequest object Returns: A dictionary describing the call. rr relative_url=rQ?&r,attached_filesrnamevalue)r7rrrritemsr quote_with_encodingkeysrrrrrr)rr relative_pathrrrr6rrrrkeyrkeyvalsheaderbatch_formatted_headers&&&&&&&&& raddFacebookAdsApiBatch.addvsD-)9)9::88M2L(L f L  1&9F)/9)7:3#&t'?'?'FG)7 9^$chhw.?(??$"xx0V %(XXejjl%;D! "  DO!)+&17v.29/&w/Y&&'=> " 4  5! &&w/ &&w/ g& 19s!(Gc  \P!VP4pVP'dRP VP4VR&VP VP VPVVPVVVR7#)aInterface to add a APIRequest to the batch. Args: request: The APIRequest object to add success (optional): A callback function which will be called with the FacebookResponse of this call if the call succeeded. failure (optional): A callback function which will be called with the FacebookResponse of this call if the call failed. Returns: A dictionary describing the call. rfields)rrrrr6rr) rdeepcopy_params_fieldsrr_method_path _file_params)rrr6rupdated_paramss&&&& r add_requestFacebookAdsApiBatch.add_requestso w7 ???'*xx'@N8 $xx??!--!&&  rc VP'gR#Rp\4pRVP/p/pVPFpV'gK VPV4K VPP VVVVR7pVP 4p.p\V4FwrV 'dV PR4p V PR4p V PR4p \V V V VPV ,R7pVP4'd7VPV ,'dVPV ,!V4KKVPV ,'dVPV ,!V4KKVPV 4K V'dVPVP4pVU u.uFqPV ,NK up VnVU u.uFqPV ,NK up VnVU u.uFp VPV ,NK up Vn VU u.uFp VPV ,NK up Vn V#R#uup iuup iuup iuup i) aMakes a batch call to the api associated with this object. For each individual call response, calls the success or failure callback function if they were specified. Note: Does not explicitly raise exceptions. Individual exceptions won't be thrown for each call that fails. The success and failure callback functions corresponding to a call should handle its success or failure. Returns: If some of the calls have failed, returns a new FacebookAdsApiBatch object with those calls. Otherwise, returns None. NrRbatch)rrrcoderr)rtuplerrrrr$ enumerater.rr=rrr __class__)rrrrr call_filesr responses retry_indicesindexrrrrinner_fb_responsers& rexecuteFacebookAdsApiBatch.executes5{{{w4;;'++Jz Z(&iinn   %  $$&  (3OE||F+||F+",,y1$4# $U+ %!%//11..u55//67HI6,,U33++E23DE4$$U+' 4* tyy1I@MN u E 2 2 NI @MN u E 2 2 NI 9F,H9F-1,C,CE,J,J9F,HI (:G,H9F-1,C,CE,J,J9F,HI (  ON,H,Hs9I II!/I&)rrrrrrNN)NNNNNN) rDrErFrGrHrrrrrrIrJrKs@rrr]s*  FP :>>rrca]tRtRtoRtR]!//4RRRRRR3RltRtRtR t R t R t R t R t RtRtRRltRtRtVtR#)FacebookRequestiz Represents an API request NFTc  T;'g\P4VnWnW nVP RR4VnWP RR43VnWPnW`n Wpn Wn Wn Wn Wn/Vn.Vn/Vn^Vn.VnVe,VP(P*P-4VnR#R#)aB Args: node_id: The node id to perform the api call. method: The HTTP method of the call. endpoint: The edge of the api call. api (optional): The FacebookAdsApi object. param_checker (optional): Parameter checker. target_class (optional): The return class of the api call. api_type (optional): NODE or EDGE type of the call. allow_file_upload (optional): Whether the call allows upload. response_parser (optional): An ObjectParser to parse response. include_summary (optional): Include "summary". api_version (optional): API version. rN)rNrr_node_idrreplace _endpointr_param_checker _target_class _api_type_allow_file_upload_response_parser_include_summaryrXrrr _file_counter_accepted_fieldsField__dict__values) rnode_idrendpointru param_checker target_classapi_typeallow_file_uploadresponse_parserinclude_summaryr[s &&&&&&&&&&&&rrFacebookRequest.__init__!s8;;>99;   !))#r2//R89 +)!"3 / /'   "  #$0$6$6$?$?$F$F$HD ! $rcVP'g/\P!RVP,R,4R\ VP 4,p\ PPV4'd*WPV&V;P ^, unV#\RV,R,4h)z Endpoint z cannot upload filessourcezCannot find file !) rr warningrrrosrisfilerr)r file_pathfile_keys&& radd_fileFacebookRequest.add_fileQs&&&   kDNN:=SS Tc$"4"455 77>>) $ $*3  h '   ! #   ,#i/#5 rcFVfV#VFpVPV4K V#r)r)rrrs&& r add_filesFacebookRequest.add_files^s' =KI MM) $ rcWP9dVPPV4WP9d/\P!VP R,V,4V#)z does not allow field )rrrr r r)rfields&&r add_fieldFacebookRequest.add_fieldesL  $ LL   & -- -   dnn/GG%O P rcFVfV#VFpVPV4K V#r)r)rrrs&& r add_fieldsFacebookRequest.add_fieldsls' >KE NN5 ! rcVPPW4'gs\P!RV,R,R,VPP V4,R,R,\ \ V44,4VPPV4'dW PV&V#VPV4VPV&V#)z value of z might not be compatible. z Expect z; z got ) r is_valid_pairr r get_typertype is_file_paramr_extract_valuer)rrrs&&&r add_paramFacebookRequest.add_paramss""00<<   kC/2NN!0099#>?AEFd5k*+ ,    , ,S 1 1%*  c " !% 3 3E :DLL  rcpVfV#VP4FpVPW!V,4K V#r)rr$)rrrs&& r add_paramsFacebookRequest.add_params~s1 >K;;=C NN3s ,! rc,\VP4#r)listrr!s&r get_fieldsFacebookRequest.get_fieldssDLL!!rcB\P!VP4#r)rrrr!s&r get_paramsFacebookRequest.get_paramss}}T\\**rc \P!VP4pVPR8Xd}VPR8Xdl\ VP VVPVPVPVPVPVPR7pVP4V#VP'dRPVP4VR&\VP 4;_uu_4pVPP#VPVP$VVVP&R7pVP)4'dVP)4hVP'd4VPP+VP-44uuRRR4#VuuRRR4# +'giR#;i)EDGErQ)target_objects_classrrrrurr object_parserrr)rrrrr[N)rrrrrCursorrrrrrrrload_next_pager open_filesrrrrXr5 parse_singler$)rrcursorrrs& rrFacebookRequest.executesGt||, >>V # (=%)%7%7|| $ 5 5II "33 F  ! ! #M <<<"xx 5F8  )) * *eyy~~||jj -- &H~~nn&&$$$,,99(--/J+ * + * * *s;A6F12(F1%F11 G c*VPWV4R#r)r)rrr6rs&&&&r add_to_batchFacebookRequest.add_to_batchs $1rc6a\VR4'dVP4#\V\4'd"VUu.uFpSP V4NK up#\V\ 4'd$\ V3RlVP 444#V#uupi)export_all_datac3l<"TF)wrSPV4SPV43xK+ R#5ir)r#).0kvrs& r 1FacebookRequest._extract_value..s5-+FQ,,Q/1D1DQ1GH+s14)hasattrr>r7r*r#dictr)rritemsf& rr#FacebookRequest._extract_values 5+ , ,((* * t $ $:?@%$D''-%@ @ t $ $-#kkm-- -L AsB)rrrrrXrrrrrrrrrrrrr)rDrErFrGrHrrrrrrr$r'r+r.rr;r#rIrJrKs@rrrso !"b).I`  "+ @2  rrcta]tRtRtoRtRRltRtRtRtRt ] t R t R t R t R tR tRtRtRtVtR#)r4iaCursor is an cursor over an object's connections. Previously called EdgeIterator. Examples: >>> me = AdAccountUser('me') >>> my_accounts = [act for act in Cursor(me, AdAccount)] >>> my_accounts [, ] Nc  ^\T;'g/4VnVPW0P4WnW nT;'gVP 4VnT;'gVP4VnT;'gVP4Vn VP VP3Vn .Vn .Vn RVnRVnRVnT;'gRVP9VnT ;'g"\%VPVPR7VnR#)a Initializes an cursor over the objects to which there is an edge from source_object. To initialize, you'll need to provide either (source_object and target_objects_class) or (api, node_id, endpoint, and object_parser) Args: source_object: An AbstractObject instance from which to inspect an edge. This object should have an id. target_objects_class: Objects traversed over will be initialized with this AbstractObject class. fields (optional): A list of fields of target_objects_class to automatically read in. params (optional): A mapping of request parameters where a key is the parameter name and its value is a string or an object which can be JSON-encoded. include_summary (optional): Include summary. api (optional): FacebookAdsApi object. node_id (optional): The ID of calling node. endpoint (optional): The edge name. object_parser (optional): The ObjectParser to parse response. FNdefault_summary)rur)rFr_assign_fields_to_params_source_object_target_objects_classget_id_assuredr get_endpointrget_apirr_queuer_finished_iteration _total_count_summaryrr_object_parser) r source_objectr2rrrrurrr3s &&&&&&&&&&rrCursor.__init__sB6<Couldn't retrieve the object summary for that type of request.z T) sort_keysindent separators)rz: )rUr7rFrr$dumpsr!s&rsummaryCursor.summarys\ == 4==$(G(G6 )H JJ &    rc HVP'dR#VP'd2RVP9d!RVP9dRVPR&VPP RVP VPR7pVP 4pVP4VnRV9dWRVR,9dIR VR,R,9d4R VR,9d&VR,R,R ,VPR &MRVnVP'd+RV9d$R VR,9dVR,R ,Vn VP'dRV9dVR,Vn VPV4Vn \VP4^8#) zsQueries server for more nodes and loads them into the internal queue. Returns: True if successful, else False. FrKrtTrQ)rpagingcursorsafternext total_count)rSrrrrrr$rrrTrUbuild_objects_from_responserRr)r response_objrs& rr5Cursor.load_next_page-sf  # # #  ! ! ! T[[ 0 T[[ (%)DKK "yy~~  JJ;;&  $$&$,,.   (+ + x))4 4 hx( (#+H#5i#@#IDKK (,D $  ! ! !  ! Xi0 0 ( 3M BD   Y(%:$Y/DM66x@ 4;;!##rcVFpVu# R#rr_)robjs& rget_oneCursor.get_one]sCJrc8VPPV4#r)rVparse_multiple)rrs&&rr|"Cursor.build_objects_from_responsebs""11(;;r)rrrSrrrrVrrRrMrUrNrTr) NNNNTNNNN)rDrErFrGrHrrZrr`rerzrhrrmrtr5rr|rIrJrKs@rr4r4sT5 n  " D"!  .$` <\V\P4'g\P!VRRR7W&KwW V&K} V#)T)rprr)r:) rrr7r r8Sequencer9rrr$rs)rparamrs& rrrps| [[]F   u668P8PRVW X Xuc&6&677 JJ%FM "5M' Mr)$facebook_business.sessionrfacebook_businessrfacebook_business.exceptionsrrrrfacebook_business.utilsr r contextlibr r six.movesr rr$rrr ImportError collections(facebook_business.adobjects.objectparserrfacebook_business.typecheckerrobjectrrNrrr4r6rr_rrrs6' .(% ! (' B5 RvRjZ-VZ-z|&|~[[|i