PIiTZddlmZddlmZmZmZddlmZddlm Z ddl Z GddeZ y))FacebookBadObjectError)FacebookAdsApiCursorFacebookRequest)AbstractObject) ObjectParserNc4eZdZdZdfd ZfdZdZdZdZe ddZ dZ d Z d Z d Zd Zd ZdZdZdZdZdZdZdZ d dZ d dZ d dZ d!dZdZ ddZeZ d"dZ d#dZ ddZ!dZ"xZ#S)$AbstractCrudObjectz Extends AbstractObject and implements methods to create, read, update, and delete. Attributes: parent_id: The object's parent's id. (default None) api: The api instance associated with this object. (default None) ctt| |xstj|_i|_|d}tj|||_ ||jd<d|_ y)ayInitializes a CRUD object. Args: fbid (optional): The id of the object ont the Graph. parent_id (optional): The id of the object's parent. api (optional): An api object which all calls will go through. If an api object is not specified, api calls will revert to going through the default api. Nz99;   !&O OOO ,# 4 $c||jvs|j||k7r||j|<tt|||dt |vr|j |||S)z?Sets an item in this CRUD object while maintaining a changelog._setitem_trigger)rrr r __setitem__dirr )rkeyvaluers rr!zAbstractCrudObject.__setitem__3sa djj DJJsOu$s! JJsO #t$rct||jxrE|jxr3|jxr!|j|jk(S)z4Two objects are the same if they have the same fbid.) isinstancerget_idrothers r__eq__zAbstractCrudObject.__eq__BsR udnn - , KKM ,$lln , KKMU\\^ + rc&|j| Sr&)r.r,s r__ne__zAbstractCrudObject.__ne__Os;;u%%%rc|xstj}t|xsi}|j||dj t t ||d<|jddg|}g}|jjD]1\}}|||} | j||j| 3|S)N,idsGET/params)r) rrdict_assign_fields_to_paramsjoinmapstrcalljsonitems _set_dataappend) clsr3r7fieldsrresponseresultrdataobjs r get_by_idszAbstractCrudObject.get_by_idsRs5^335fl# $$VV4S#/u 88  E  "--///1 JD$d$C MM$  MM#   rct|dr/t|jdr||jjS|dS)z8Returns the object's fbid if set. Else, it returns None.Fieldr )hasattrrJr rs rr+zAbstractCrudObject.get_idfs8&-dG&<U\A]tDJJMM"mcghlcmmrcvd}tj| |jxstjS)Nparent_id is being deprecated.)rrrrget_default_account_idrrs r get_parent_idz AbstractCrudObject.get_parent_idks.:(/I."G"G"IIrc|jS)z= Returns the api associated with the object. )rrLs rget_apizAbstractCrudObject.get_apiqsyyrc|j|jjs"td|jj z|j S)z~Returns the fbid of the object. Raises: FacebookBadObjectError if the object does not have an id. z)%s object needs an id for this operation.)getrJr rr__name__r+rLs rget_id_assuredz!AbstractCrudObject.get_id_assuredwsH xx &(;..))*  {{}rcd}tj||js"td|jj z|jS)zReturns the object's parent's fbid. Raises: FacebookBadObjectError if the object does not have a parent id. rNz/%s object needs a parent_id for this operation.)rrrQrrrVrPs rget_parent_id_assuredz(AbstractCrudObject.get_parent_id_assuredsT ;(!!#(A..))*  !!##rcn|j}|s"td|jjz|S)ztReturns the fbid of the object. Raises: FacebookBadObjectError if get_api returns None. z%s does not yet have an associated api object. Did you forget to instantiate an API session with: FacebookAdsApi.init(app_id, app_secret, access_token))rSrrrV)rrs rget_api_assuredz"AbstractCrudObject.get_api_assureds@ lln(H..))*  rcJi|_d|jvr |jd=|S)Nfilename)rrrLs r_clear_historyz!AbstractCrudObject._clear_historys&  # :& rctt|D]&}||||<|jj|d(||_|S)zo Sets object's data as if it were read from the server. Warning: Does not log changes. N)r;r<rr'_json)rrFr#s rr@zAbstractCrudObject._set_datasJ sD> )CS DI MM  c4 (  )   rc8|j|jS)z Returns a dictionary of property names mapped to their values for properties modified from their original values. ) export_valuerrLs rexport_changed_dataz&AbstractCrudObject.export_changed_datas   //rc"|jS)zU Deprecated. Use export_all_data() or export_changed_data() instead. )rcrLs r export_datazAbstractCrudObject.export_datas''))rc4||jj=|S)zClears the object's fbid.)rJr rLs rclear_idzAbstractCrudObject.clear_ids   rc$|jfS)z6Returns the node's relative path as a tuple of tokens.)rWrLs r get_node_pathz AbstractCrudObject.get_node_paths##%''rc@dj|jS)z#Returns the node's path as a tuple.r5)r:rirLs rget_node_path_stringz'AbstractCrudObject.get_node_path_stringsxx**,--rc Td}tj|jr"tdjj zdt vr"tdjj z|sin|j}|jjd}tdr"jjd}nKtjd jj jt#  }|j%||j'||fd } fd } |j)|| | S|j+} j-| j.j1S)aCreates the object by calling the API. Args: batch (optional): A FacebookAdsApiBatch object. If specified, the call will be added to the batch. 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. 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. Returns: self if not a batch call. the return value of batch.add if a batch call. zO`remote_create` is being deprecated, please update your code with new function.z#This %s object was already created. get_endpointz Cannot create object of type %s.N api_createTpendingPOST reuse_objectnode_idmethodendpointr target_classresponse_parserczj|jjr |yyr&)r@r>r^rDrsuccesss rcallback_successz:AbstractCrudObject.remote_create..callback_successs1x}}/##%H%rcr |yyr&rDfailures rcallback_failurez:AbstractCrudObject.remote_create..callback_failureH%rrequestr|r)rrr+rrrVr" TypeErrorcopyupdateexport_all_datarKrnrYrrmrr add_params add_files add_requestexecuter@r`r^) rbatchrfilesr7r| api_versionrrr}rrDs ` ` ` r remote_createz AbstractCrudObject.remote_creates4l( ;;=(5..))* T*>"nn5567 7"v{{} d**,- 4 &ood&@&@&BDoQG%224**,II!^^ ,!%! G 6"%   & &$$((%  (H NN8>> *    !Krc d}tj|t|xsi}tdrj d}n=t j ddjjt}|j||j||!fd } fd } |j|| | } | S|jS) aReads the object by calling the API. Args: batch (optional): A FacebookAdsApiBatch object. If specified, the call will be added to the batch. fields (optional): A list of fields to read. 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. 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. Returns: self if not a batch call. the return value of batch.add if a batch call. zM`remote_read` is being deprecated, please update your code with new function.api_getTror4r5rrrtcZj|jr |yyr&)r@r>r{s rr}z8AbstractCrudObject.remote_read..callback_successZs%x}}/H%rcr |yyr&rrs rrz8AbstractCrudObject.remote_read..callback_failure`rrr)rrr8rKrrrWrrrr add_fieldsrr) rrrrCr7r|rrrr}r batch_calls ` ` ` r remote_readzAbstractCrudObject.remote_read+s6j(fl# 4 #ll4l0G%++-II!^^ ,!%! G 6"6"   &  &**((+J  ??$DKrc Dd}tj||sin|j}|jj j |t drjd}n=tjddjjt}|j||j||!fd } fd } |j|| | } | S|j!j#S) aUpdates the object by calling the API with only the changes recorded. Args: batch (optional): A FacebookAdsApiBatch object. If specified, the call will be added to the batch. 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. 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. Returns: self if not a batch call. the return value of batch.add if a batch call. zO`remote_update` is being deprecated, please update your code with new function. api_updateTrorqr5rrrtc<jr |yyr&)r^r{s rr}z:AbstractCrudObject.remote_update..callback_successs##%H%rcr |yyr&rrs rrz:AbstractCrudObject.remote_update..callback_failurerrr)rrrrrcr@rKrrrWrrrrrrrr^) rrrrr7r|rrrr}rrs ` ` ` r remote_updatez AbstractCrudObject.remote_updateps4l(!v{{} d..01 v 4 &oodo3G%++-II!^^ ,!%! G 6"%   &  &**((+J   OO     !Krcnd}tj|tdrjd}n't j ddj }|j||!fd}fd } |j||| } | S|jjS) a8Deletes the object by calling the API with the DELETE http method. Args: batch (optional): A FacebookAdsApiBatch object. If specified, the call will be added to the batch. 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. 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: self if not a batch call. the return value of batch.add if a batch call. zO`remote_delete` is being deprecated, please update your code with new function. api_deleteTroDELETEr5)rurvrwrc<jr |yyr&)rgr{s rr}z:AbstractCrudObject.remote_delete..callback_successs H%rcr |yyr&rrs rrz:AbstractCrudObject.remote_delete..callback_failurerrr) rrrKrrrWrrrrrg) rrrr7r|rrrr}rrs ` ` ` r remote_deletez AbstractCrudObject.remote_deletes.l( 4 &oodo3G%++-II G 6"   &  &**((+J   OO  MMOKrcd}tj||jr|j|i|S|j|i|S)zz Calls remote_create method if object has not been created. Else, calls the remote_update method. zM`remote_save` is being deprecated, please update your code with new function.)rrr+rr)rargskwargsrs r remote_savezAbstractCrudObject.remote_savesO j( ;;=%4%%t6v6 6%4%%t6v6 6rcdt|vsdt|jvr"td|jjz|j d|jj i|||S)NStatusarchivedz!Cannot archive object of type %s.status)r7rrr|)r"rrrrVrnr)rrrr|s rremote_archivez!AbstractCrudObject.remote_archivesw 3t9 $ #dkk:J(J?"nn5567 7$++..   rcP|}t||||||}|r|j|S)z Returns Cursor with argument self as source_object and the rest as given __init__ arguments. Note: list(iterate_edge(...)) can prefetch all the objects. )rCr7include_summaryrw)rload_next_page) rtarget_objects_classrCr7fetch_first_pagerrw source_objectcursors r iterate_edgezAbstractCrudObject.iterate_edges;   +     ! ! # rcddlm} | }|j|||||} |r| S|si}n t|}|jj ||||j }|jjd|j|f|j} |} d| vr| d| d<| j| | S)Nr) AdReportRun)rrrqr6 report_run_idr ) 'facebook_business.adobjects.adreportrunrrr8rr9rmr[r=rWr>r@) rrrCr7is_asyncrrwr synchronoussynchronous_iteratorrDrEs riterate_edge_asyncz%AbstractCrudObject.iterate_edge_async1s H #l #00  (+ 1  ' 'F&\F //?  +88:H'')..   "H -/  $&  h &%o6HTN" rcp|sin|j}d|d<|j||||D]}|cSy)z Returns first object when iterating over Cursor with argument self as source_object and the rest as given __init__ arguments. 1limit)rCr7rwN)rr)rrrCr7rwrGs r edge_objectzAbstractCrudObject.edge_objectjsS "v{{}w$$  %  C J  rc2|js tdy)Nz)Api call cannot be made if api is not set)rrrLs r assure_callzAbstractCrudObject.assure_call|syy(;= =r)NNN)NNNNNN)NNNNN)NNTTN)NNFTN)$rV __module__ __qualname____doc__rr!r(r.r0 classmethodrHr+rQrSrWrYr[r^r@rcrergrirkrrrrrrsaverrrr __classcell__)rs@rr r s.%* %  &&n J   $$ 0* (.OjANDT 8z 7  & D 6?CHL$(7r$=rr ) facebook_business.exceptionsrfacebook_business.apirrr*facebook_business.adobjects.abstractobjectr(facebook_business.adobjects.objectparserrrr rrrrs. FAj =j =r