+
    TŎiG                     P    ^ RI t ^ RIt^ RIHt ^ RIHt ^ RIHt  ! R R]4      t	R# )    N)Content)	Normalize)DeliveryCategoryc                     a  ] tR t^t o Rt/ RRbRRbRRbRRbRRbR	R
bRRbRRbRRbRRbRRbRRbRRbRRbRRbRRbtRRRRRRRRRRRRRRR/ 3R lt]R 4       t]P                  R 4       t]R 4       t
]
P                  R 4       t
]R 4       t]P                  R  4       t]R! 4       t]P                  R" 4       t]R# 4       t]P                  R$ 4       t]R% 4       t]P                  R& 4       t]R' 4       t]P                  R( 4       t]R) 4       t]P                  R* 4       t]R+ 4       t]P                  R, 4       t]R- 4       t]P                  R. 4       t]R/ 4       t]P                  R0 4       t]R1 4       t]P                  R2 4       t]R3 4       t]P                  R4 4       t]R5 4       t]P                  R6 4       t]R7 4       t]P                  R8 4       t]R9 4       t]P                  R: 4       tR; tR< tR= tR> tR? tR@ tRA tRBt V t!R# )C
CustomDataz?
CustomData includes additional business data about the event.
valuefloatnet_revenuecurrencystrcontent_namecontent_categorycontent_idsz	list[str]contentszlist[Content]content_typeorder_idpredicted_ltv	num_itemsintstatussearch_stringdelivery_categoryr   item_numbercustom_propertiesdictNc                4   R V n         R V n        R V n        R V n        R V n        R V n        R V n        R V n        R V n        R V n	        R V n
        R V n        R V n        R V n        R V n        R V n        Ve   Wn        Ve   W n        Ve   W0n        Ve   W@n        Ve   WPn        Ve   W`n        Ve   Wpn        Ve   Wn        V	e   Wn        V
e   Wn        Ve   Wn        Ve   Wn        Ve   Wn        Ve   Wn        Ve   Wn        V'       d
   VV n        R # R # )N) _value_net_revenue	_currency_content_name_content_category_content_ids	_contents_content_type	_order_id_predicted_ltv
_num_items_status_search_string_delivery_category_item_number_custom_propertiesr   r
   r   r   r   r   r   r   r   r   r   r   r   r   r   r   )selfr   r
   r   r   r   r   r   r   r   r   r   r   r   r   r   r   s   &&&&&&&&&&&&&&&&&ځ/Users/ahmad/.openclaw/workspace/scripts/.venv/lib/python3.14/site-packages/facebook_business/adobjects/serverside/custom_data.py__init__CustomData.__init__3   s<   *  !!% !"""& "&J"*$M# ,'$4!"*$M# ,$M$!. &N K$!.(%6""*%6D"     c                    V P                   # )zGets the value.

A numeric value associated with this event. This could be a monetary value or a value in some other metric.

:return: The value.
:rtype: float or int
)r   r-   s   &r.   r   CustomData.valuey   s     {{r1   c                n    \        V\        \        34      '       g   \        RV,          4      hWn        R# )zSets the value.

A numeric value associated with this event. This could be a monetary value or a value in some other metric.

:param value: The value.
:type: float or int
z?CustomData.value must be a float or int. TypeError on value: %sN)
isinstancer	   r   	TypeErrorr   )r-   r   s   &&r.   r   r4      s,     %%..]`eeffr1   c                    V P                   # )zyGets the net_revenue.

A numeric net revenue associated with this event.

:return: The net_revenue.
:rtype: float or int
)r   r3   s   &r.   r
   CustomData.net_revenue   s        r1   c                n    \        V\        \        34      '       g   \        RV,          4      hWn        R# )zSets the net_revenue.

A numeric net revenue associated with this event.

:param net_revenue: The net_revenue.
:type: float or int
zECustomData.net_revenue must be a float or int. TypeError on value: %sN)r6   r	   r   r7   r   )r-   r
   s   &&r.   r
   r9      s-     +s|44cfqqrr'r1   c                    V P                   # )zGets the currency.

The currency for the value specified, if applicable. Currency must be a valid ISO 4217 three digit currency code.

:return: The currency.
:rtype: str
r   r3   s   &r.   r   CustomData.currency        ~~r1   c                    Wn         R# )zSets the currency.

The currency for the value specified, if applicable. Currency must be a valid ISO 4217 three digit currency code.

:param currency: The currency.
:type: str
Nr<   )r-   r   s   &&r.   r   r=      	     "r1   c                    V P                   # )zGets the content name.

The name of the page or product associated with the event. Example: 'lettuce'.

:return: The content name.
:rtype: str
r    r3   s   &r.   r   CustomData.content_name   s     !!!r1   c                    Wn         R# )zSets the content name.

The name of the page or product associated with the event. Example: 'lettuce'.

:param content_name: The content name.
:type: str
NrB   )r-   r   s   &&r.   r   rC      s
     *r1   c                    V P                   # )zGets the content category.

The category of the content associated with the event. Example: 'grocery'

:return: The content category.
:rtype: str
r!   r3   s   &r.   r   CustomData.content_category   s     %%%r1   c                    Wn         R# )zSets the content category.

The category of the content associated with the event. Example: 'grocery'

:param content_category: The content category.
:type: str
NrF   )r-   r   s   &&r.   r   rG      s
     "2r1   c                    V P                   # )a[  Gets the content ids.

The content IDs associated with the event, such as product SKUs for items in an
AddToCart event: ['ABC123', 'XYZ789']. If content_type is a product, then your content IDs must
be an array with a single string value. Otherwise, this array can contain any number of string values.

:return: The content ids.
:rtype: list[str]
r"   r3   s   &r.   r   CustomData.content_ids   s        r1   c                    Wn         R# )ag  Sets the content_ids.

The content IDs associated with the event, such as product SKUs for items in an AddToCart event:
 ['ABC123', 'XYZ789']. If content_type is a product, then your content IDs must be an array with
 a single string value. Otherwise, this array can contain any number of string values.

:param content_ids: The content_ids.
:type: list[str]
NrJ   )r-   r   s   &&r.   r   rK      s
     (r1   c                    V P                   # )zGets the contents.

A list of Content objects that contain the product IDs associated with the event plus information about
the products. id, quantity, and item_price are available fields.

:return: The contents.
:rtype: list[Content]
r#   r3   s   &r.   r   CustomData.contents	  s     ~~r1   c                    Wn         R# )zSets the contents.

A list of Content objects that contain the product IDs associated with the event plus information about
the products. id, quantity, and item_price are available fields.

:param contents: The contents.
:type: list[Content]
NrN   )r-   r   s   &&r.   r   rO     s	     "r1   c                    V P                   # )a  Gets the content type.

A String equal to either 'product' or 'product_group'. Set to product if the keys you send content_ids or
contents represent products. Set to product_group if the keys you send in content_ids represent product groups.

:return: The content type.
:rtype: str
r$   r3   s   &r.   r   CustomData.content_type"  s     !!!r1   c                    Wn         R# )a%  Sets the content type.

A String equal to either 'product' or 'product_group'. Set to product if the keys you send content_ids or
contents represent products. Set to product_group if the keys you send in content_ids represent product groups.

:param content_type: The content type.
:type: str
NrR   )r-   r   s   &&r.   r   rS   .  s
     *r1   c                    V P                   # )zgGets the order id.

The order ID for this transaction as a String.

:return: The order id.
:rtype: str
r%   r3   s   &r.   r   CustomData.order_id;  r>   r1   c                    Wn         R# )znSets the order id.

The order ID for this transaction as a String.

:param order_id: The order id.
:type: str
NrV   )r-   r   s   &&r.   r   rW   F  r@   r1   c                    V P                   # )z~Gets the predicted ltv.

The predicted lifetime value of a conversion event

:return: The predicted ltv.
:rtype: float or int
)r&   r3   s   &r.   r   CustomData.predicted_ltvR  s     """r1   c                n    \        V\        \        34      '       g   \        RV,          4      hWn        R# )zSets the predicted_ltv.

The predicted lifetime value of a conversion event

:param predicted_ltv: The predicted_ltv.
:type: float or int
zOCustomData.predicted_ltv must be a float or int. TypeError on predicted_ltv: %sN)r6   r	   r   r7   r&   )r-   r   s   &&r.   r   rZ   ]  s-     -%66mp}}~~+r1   c                    V P                   # )zGets the num items.

Use only with InitiateCheckout events. The number of items that a user tries to buy during checkout.

:return: The num_items.
:rtype: int
r'   r3   s   &r.   r   CustomData.num_itemsj  s     r1   c                    Wn         R# )zSets the num items.

Use only with InitiateCheckout events. The number of items that a user tries to buy during checkout.

:param num_items: The num_items.
:type: int
Nr]   )r-   r   s   &&r.   r   r^   u  s	     $r1   c                    V P                   # )zGets the status.

Use only with CompleteRegistration events. The status of the registration event, as a String.

:return: The status.
:rtype: str
r(   r3   s   &r.   r   CustomData.status  s     ||r1   c                    Wn         R# )zSets the status.

Use only with CompleteRegistration events. The status of the registration event, as a String.

:param status: The status.
:type: str
Nra   )r-   r   s   &&r.   r   rb     s	     r1   c                    V P                   # )zNGets the search query made by a user.

:return: The search query.
:rtype: str
r)   r3   s   &r.   r   CustomData.search_string  s     """r1   c                    Wn         R# )zSets the search query made by a user.

Use only with Search events. A search query made by a user.

:param search_string: The search query.
:type: str
Nre   )r-   r   s   &&r.   r   rf     s
     ,r1   c                    V P                   # )zcGets the Type of Delivery Category.

:return: The Delivery Category type.
:rtype: DeliveryCategory
)r*   r3   s   &r.   r   CustomData.delivery_category       &&&r1   c                b    \        V\        4      '       g   \        RV,           4      hWn        R# )zSets the Type of Delivery Category.

Use with Purchase events.

:param delivery_category: The Delivery Category type.
:type: DeliveryCategory
zMdelivery_category must be of type DeliveryCategory. Passed invalid category: N)r6   r   r7   r*   )r-   r   s   &&r.   r   ri     s1     +-=>>kn  A  A"3r1   c                    V P                   # )z=Gets the item number.

:return: The item number.
:rtype: str
r+   r3   s   &r.   r   CustomData.item_number  s        r1   c                    Wn         R# )zGSets the item number.

:param item_number: The item number.
:type: str
Nrm   )r-   r   s   &&r.   r   rn     s
     (r1   c                    V P                   # )zwGets the custom properties to be included in the Custom Data.

:return: The custom properties dictionary.
:rtype: dict
r,   r3   s   &r.   r   CustomData.custom_properties  rj   r1   c                    Wn         R# )zSets the custom properties to be included in the Custom Data.

These are properties that are not defined in the standard list of the custom data.

:param custom_properties: The custom properties dictionary.
:type: dict
Nrq   )r-   r   s   &&r.   r   rr     s
     #4r1   c                "    W P                   V&   R# )zAdds the custom property (key, value) to the custom property bag.

:param key: The Key for the property to be added.
:type: str
:param value: The Value for the property to be added.
:type: str
N)r   )r-   keyr   s   &&&r.   add_custom_propertyCustomData.add_custom_property  s     ',s#r1   c                ~   R V P                   RV P                  R\        P                  ! RV P                  4      RV P
                  RV P                  RV P                  RV P                  RV P                  RV P                  R	V P                  R
V P                  RV P                  RV P                  /pV P                  e   V P                  P                   VR&   V P                   e?   . pV P                    F(  pVf   K	  VP#                  VP%                  4       4       K*  	  W!R&   V P&                  '       dV   V P&                   FE  pWAP)                  4       9   d   \+        RV,           R,           4      hV P&                  V,          W&   KG  	  VP-                  4        UUu/ uF  w  rVVf   K  WVbK  	  pppV# u uppi )r   r
   r   r   r   r   r   r   r   r   r   r   r   r   r   z$Duplicate key in custom_properties:"z~". Please make sure the keys defined in the custom_properties are not already available in standard custom_data property list.)r   r
   r   normalize_field_skip_hashingr   r   r   r   r   r   r   r   r   r   r   r   r   append	normalizer   keys	Exceptionitems)r-   normalized_payloadr   contentru   kvs   &      r.   r{   CustomData.normalize  s   TZZ4++	>>z4==YD-- 5 54++D--T//dkkT//4++
  !!-6:6L6L6R6R23==$H==&OOG$5$5$78 ) .6z* !!!--1133#$JS$P  TT  %T  U  U*.*@*@*E"' .
 0B/G/G/I[/ItqQdad/I[!! \s   !F9.F9c                   / p\         P                  ! V P                  4       F  w  r#\        W4      p\	        V\
        4      '       d   \        \        R V4      4      W&   K@  \        VR4      '       d   VP                  4       W&   Kf  \	        V\        4      '       d)   \        \        R VP                  4       4      4      W&   K  WAV&   K  	  \        \        \        4      '       d   V P                  4        F	  w  rTWAV&   K  	  V# )z&Returns the model properties as a dictc                 J    \        V R 4      '       d   V P                  4       # T # )to_dicthasattrr   )xs   &r.   <lambda>$CustomData.to_dict.<locals>.<lambda>&  s    WQ	-B-BaiikIIr1   r   c                 x    \        V ^,          R4      '       d!   V ^ ,          V ^,          P                  4       3# T # )   r   r   )items   &r.   r   r   -  s9    tAw	22 #'q'47??+<!= "=8<"=r1   )six	iteritemsparam_typesgetattrr6   listmapr   r   r   r~   
issubclassr   )r-   resultattr_r   ru   s   &     r.   r   CustomData.to_dict  s    }}T%5%56GDD'E%&&#CI%   	**$}}E4((#C=KKM%    %t! 7" j$''"jjl
#s + r1   c                J    \         P                  ! V P                  4       4      # )z.Returns the string representation of the model)pprintpformatr   r3   s   &r.   to_strCustomData.to_str9  s    ~~dlln--r1   c                "    V P                  4       # )zFor `print` and `pprint`)r   r3   s   &r.   __repr__CustomData.__repr__=  s    {{}r1   c                d    \        V\        4      '       g   R# V P                  VP                  8H  # )z&Returns true if both objects are equalF)r6   r   __dict__r-   others   &&r.   __eq__CustomData.__eq__A  s%    %,,}}..r1   c                    W8X  * # )z*Returns true if both objects are not equal r   s   &&r.   __ne__CustomData.__ne__H  s      r1   ) r!   r"   r    r$   r#   r   r,   r*   r+   r   r'   r%   r&   r)   r(   r   r   r   r   r   r   r   r   r   r   r
   r   r   r   r   r   r   )"__name__
__module____qualname____firstlineno____doc__r   r/   propertyr   setterr
   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rv   r{   r   r   r   r   r   __static_attributes____classdictcell__)__classdict__s   @r.   r   r      s    w 	E 		
 	E 	{ 	O 	 	E 	 	U 	% 	% 	0 	u  	f!K* #D7L   \\
 
 ! ! 
( 
(   __	" 	" " " 	* 	* & & 	2 	2 
! 
! ( ( 	 	 __
" 
" 	" 	" 
* 
*   __	" 	" # # 
, 
,   	$ 	$   ]]	 	 # # 	, 	, ' ' 4 4 ! ! ( ( ' ' 	4 	4
,$"L6./! !r1   r   )
r   r   .facebook_business.adobjects.serverside.contentr   0facebook_business.adobjects.serverside.normalizer   8facebook_business.adobjects.serverside.delivery_categoryr   objectr   r   r1   r.   <module>r      s$   *  
 B F Un! n!r1   