iNZdZddlZddlmZddlmZddlZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZeeZdZdZgdZGddZ y)u Meta Marketing API 클라이언트 모듈 Usage: from utils.meta_ads_client import MetaAdsClient client = MetaAdsClient() campaigns = client.list_campaigns() N)Path)Any)Ad) AdAccount) AdCreative)AdImage)AdSet)Campaign)FacebookAdsApi)FacebookRequestError) load_env_keys) get_loggerz https://graph.facebook.com/v25.0z/home/jay/workspace/.env.keys) impressionsclicksspendcpccpmctractionscBeZdZdZefdeddfdZdedededdfd Zed e de fd Z defd Z d eddfdZ de fdZde fdZ d3deedzdedee fdZ d4dedeedzde fdZ d5dededededzdeedzde f dZdede de fdZdedefdZ d6dedzdeedzdedee fdZ d7dededed e d!ed"edede fd#Zd$ede de fd%Zd$edefd&Zd'edefd(Z d4ded)ed*ed+ed,edzde f d-Z d8d.ed/edeedzd0edzd1e dzdee f d2Zy)9 MetaAdsClientu"Meta Marketing API 클라이언트 env_keys_pathreturnNcN||_t|gd}|Dcgc]$}tjj |r#|&}}|rt d|tjd|_tjd|_tjd|_tjd|_ |j|j |j|jt|j|_ tjd|jycc}w) u MetaAdsClient 초기화. Args: env_keys_path: .env.keys 파일 경로 (기본값: /home/jay/workspace/.env.keys) Raises: ValueError: 필수 환경변수가 누락된 경우 ) META_APP_IDMETA_APP_SECRETMETA_ACCESS_TOKENMETA_AD_ACCOUNT_IDu필수 환경변수 누락: rrrru.MetaAdsClient 초기화 완료 (account_id=%s)N)_env_keys_pathr osenvironget ValueError_app_id _app_secret _access_token_ad_account_id _init_apir_accountloggerinfo)selfr required_keyskmissings F/home/jay/workspace/.worktrees/task-2116-dev1/utils/meta_ads_client.py__init__zMetaAdsClient.__init__/s,m$ ,E2::>>!3D1EE ;G9EF Fzz-0 ::&78ZZ(;< jj)=> t||T%5%5t7I7IJ!$"5"56  DdFYFYZFs $D"D"app_id app_secret access_tokenc\tj|||tjdy)uFacebookAdsApi 초기화.uFacebookAdsApi 초기화 완료N)r initr*debug)r,r2r3r4s r0r(zMetaAdsClient._init_apiTs!FJ = 67objcPt|dr|jSt|S)u+SDK 반환 객체를 순수 dict로 변환.export_all_data)hasattrr;dict)r9s r0_to_dictzMetaAdsClient._to_dictYs( 3) *&&( (Cyr8ctd}d|j|j|jd}tj dt j||d}|j|j}d|vrtd|jd |d}||_|tjd <|j|j|j|tjd |jd |S) un 단기 토큰을 장기 토큰(60일)으로 교환한다. GET https://graph.facebook.com/v25.0/oauth/access_token 직접 호출. Returns: str: 새로 발급된 장기 액세스 토큰 Raises: requests.HTTPError: API 호출 실패 시 ValueError: 응답에 access_token이 없을 경우 z/oauth/access_tokenfb_exchange_token) grant_type client_id client_secretr@u장기 토큰 교환 요청 중paramstimeoutr4u-토큰 교환 응답에 access_token 없음: errorru+장기 토큰 교환 성공 (token_type=%s) token_type)_GRAPH_API_BASEr$r%r&r*r7requestsr"raise_for_statusjsonr#r r!r(r+)r,urlrFrespdata new_tokens r0exchange_tokenzMetaAdsClient.exchange_tokends!!!45-!--!%!3!3    67||C; yy{  %LTXXV]M^L_`a a( &*3 &' t||T%5%5yA A488LCYZr8rQct|j}|jstj d|y|j dj d}d}g}|D]}|j}d}d } |j|r|jd|d d}@|j| r)|jd s|jd |d d}z|j||s*|jd |d tj d |jdj|d|tjd<||_tjdy)u .env.keys 파일의 META_ACCESS_TOKEN 값을 업데이트한다. 파일 전체를 읽고 해당 라인만 교체 후 덮어쓴다. Args: new_token: 교체할 새 액세스 토큰 문자열 u$.env.keys 파일이 없습니다: %sNzutf-8)encodingT)keependsFzexport META_ACCESS_TOKEN=zMETA_ACCESS_TOKEN= exportz export META_ACCESS_TOKEN=uCMETA_ACCESS_TOKEN 라인이 없어 파일 끝에 추가했습니다ru9.env.keys 파일의 META_ACCESS_TOKEN 업데이트 완료)rrexistsr*warning read_text splitlinesstrip startswithappend write_textjoinr r!r&r+) r,rQpathlinesupdated new_lineslinestripped prefix_export prefix_plains r0update_env_tokenzMetaAdsClient.update_env_tokensSD''({{} NNA4 H 0;;T;J  'Dzz|H7M/L""=1  #.>-?@   23||C; zz&&) 4dhhz6JK r8c:tjjtjjtjjtjj tjj tjjtjjg} |jj|}tjd|j|S#t$r}tjd|d}~wwxYw)u 광고 계정 상태, 잔액, 스펜딩 한도 정보를 반환한다. Returns: dict: account_status, balance, spend_cap, amount_spent, currency, timezone_name, name 포함 dict fieldsu계정 정보 조회 완료u계정 정보 조회 실패: %sN)rFieldnameaccount_status amount_spentbalance spend_capcurrency timezone_namer)api_getr*r7r>r rH)r,rsrPes r0get_account_infozMetaAdsClient.get_account_infos OO OO * * OO ( ( OO # # OO % % OO $ $ OO ) )  ==(((7D LL6 7==& &#  LL:A >  s3AC55 D>DDrslimitc|tjjtjjtjjtjj tjj tjjtjjg} |jj|d|i}t|Dcgc]}|j|}}tjdt||Scc}w#t $r}tj#d|d}~wwxYw)u 광고 계정의 캠페인 목록을 반환한다. Args: fields: 반환할 필드 목록. None이면 기본 필드 사용. limit: 최대 반환 개수 (기본값 25) Returns: list[dict]: 캠페인 정보 목록 NrrsrFu%캠페인 목록 조회 완료: %d건u"캠페인 목록 조회 실패: %s)r rtrustatus objective daily_budgetlifetime_budget created_time updated_timer) get_campaignslistr>r*r7lenr rH)r,rsr campaignscror}s r0list_campaignszMetaAdsClient.list_campaignss >##%%((++..++++F  33'4I15Y@1dmmA&@F@ LL@#f+ NMA$  LL=q A  s*5,D!!D9"D!D!! E*EE campaign_idcD|tjjtjjtjjtjj tjj tjjtjjg} t|j|}|j|}tjd||S#t$r}tjd||d}~wwxYw)u 단일 캠페인 정보를 반환한다. Args: campaign_id: 캠페인 ID fields: 반환할 필드 목록. None이면 기본 필드 사용. Returns: dict: 캠페인 정보 Nrru캠페인 조회 완료: id=%su#캠페인 조회 실패 (id=%s): %s)r rtrurrrrrrr|r>r*r7r rH)r,rrscampaignror}s r0 get_campaignzMetaAdsClient.get_campaign s >##%%((++..++++F  ,44F4CH]]8,F LL9; GM#  LL> Q O  s5AC99 DDDrurrrspecial_ad_categoriesctjj|tjj|tjj|d||ngi}|||tjj < |j jg|}|j|}tjd|jd||S#t$r} tjd| d} ~ wwxYw)u 새 캠페인을 생성한다. Args: name: 캠페인 이름 objective: 캠페인 목표 (예: OUTCOME_AWARENESS, OUTCOME_TRAFFIC) status: 초기 상태 (기본값: PAUSED) daily_budget: 일일 예산 (센트/원 단위). None이면 설정하지 않음. special_ad_categories: 특수 광고 카테고리 목록. None이면 빈 리스트. Returns: dict: 생성된 캠페인 정보 (id, name 등) rNru&캠페인 생성 완료: id=%s name=%sidu캠페인 생성 실패: %s)r rtrurrrr)create_campaignr>r*r+r"r rH) r,rurrrrrFrror}s r0rzMetaAdsClient.create_campaign-s, NN   NN $ $i NN ! !6 #>S>_%:eg "   #2>F8>>.. / }}44Bv4NH]]8,F KK@&**TBRTX YM#  LL6 :  s7AC C2C--C2rFc  t|}|j|}tjd|t |j |j |S#t$r}tjd||d}~wwxYw)u 기존 캠페인을 업데이트한다. Args: campaign_id: 캠페인 ID **params: 업데이트할 필드 (name, status, daily_budget 등) Returns: dict: API 응답 rFu.캠페인 업데이트 완료: id=%s fields=%su)캠페인 업데이트 실패 (id=%s): %sN) r api_updater*r+rkeysr>r rH)r,rrFrror}s r0update_campaignzMetaAdsClient.update_campaignTsy  ,H(((7F KKH+W[\b\g\g\iWj k==( (#  LLDkST U  AA B'A??Bc t|jtjd|y#t$r}tj d||d}~wwxYw)u 캠페인을 삭제한다 (상태를 DELETED로 설정). Args: campaign_id: 삭제할 캠페인 ID Returns: bool: 삭제 성공 여부 u캠페인 삭제 완료: id=%sTu#캠페인 삭제 실패 (id=%s): %sN)r api_deleter*r+r rH)r,rr}s r0delete_campaignzMetaAdsClient.delete_campaignhsN  [ ! , , . KK8+ F#  LL> Q O  /2 AAAc|tjjtjjtjjtjj tjj tjjtjjtjjg}d|i} |rt|j||}n|jj||}t|Dcgc]}|j|}}tj!dt#||Scc}w#t$$r}tj'd|d}~wwxYw)u 광고세트 목록을 반환한다. Args: campaign_id: 지정 시 해당 캠페인의 광고세트만 반환. None이면 계정 전체 광고세트 반환. fields: 반환할 필드 목록. None이면 기본 필드 사용. limit: 최대 반환 개수 (기본값 25) Returns: list[dict]: 광고세트 정보 목록 Nrru(광고세트 목록 조회 완료: %d건u%광고세트 목록 조회 실패: %s)r rtrurr targetingoptimization_goal billing_event start_timeend_timer get_ad_setsr)rr>r*r7rr rH) r,rrsrrFadsetsaror}s r0 list_adsetszMetaAdsClient.list_adsets~s!$ >    "" (( %% -- )) && $$ F5! !+.::&QW:X22&2P04V =1dmmA&=F= LLCS[ QM>$  LL@! D  s+A EE3"EE F$E;;Frrrcptjj|tjj|tjj|tjj |tjj |tjj|tjj|i} |jjg|} |j| } tjd| jd|| S#t$r} tj!d| d} ~ wwxYw)u 광고세트를 생성한다. Args: campaign_id: 상위 캠페인 ID name: 광고세트 이름 daily_budget: 일일 예산 (센트/원 단위) targeting: 타겟팅 설정 dict optimization_goal: 최적화 목표 (예: REACH, LINK_CLICKS) billing_event: 과금 이벤트 (예: IMPRESSIONS, LINK_CLICKS) status: 초기 상태 (기본값: PAUSED) Returns: dict: 생성된 광고세트 정보 ru)광고세트 생성 완료: id=%s name=%sru광고세트 생성 실패: %sN)r rtrurrrrrrr) create_ad_setr>r*r+r"r rH) r,rrurrrrrrFadsetror}s r0 create_adsetzMetaAdsClient.create_adsets4 KK  d KK # #[ KK $ $l KK ! !9 KK ) )+< KK % %} KK  "  MM//r&/IE]]5)F KKCVZZPTEUW[ \M#  LL91 =  s:AD D5D00D5adset_idc  t|}|j|}tjd|t |j |j |S#t$r}tjd||d}~wwxYw)u 기존 광고세트를 업데이트한다. Args: adset_id: 광고세트 ID **params: 업데이트할 필드 (name, status, daily_budget, targeting 등) Returns: dict: API 응답 ru1광고세트 업데이트 완료: id=%s fields=%su,광고세트 업데이트 실패 (id=%s): %sN) r rr*r+rrr>r rH)r,rrFrror}s r0 update_adsetzMetaAdsClient.update_adsetsx (OE%%V%4F KKKXW[\b\g\g\iWj k==( (#  LLGST U  rc t|jtjd|y#t$r}tj d||d}~wwxYw)u 광고세트를 삭제한다. Args: adset_id: 삭제할 광고세트 ID Returns: bool: 삭제 성공 여부 u!광고세트 삭제 완료: id=%sTu&광고세트 삭제 실패 (id=%s): %sN)r rr*r+r rH)r,rr}s r0 delete_adsetzMetaAdsClient.delete_adsetsM  (O & & ( KK;X F#  LLA8Q O  r image_pathct|}|jstd|tjj t |i} |jjg|}|j|}d|vr|d}tt|}||}|jdd}tjd|j||S#t $r'} tj#d|j| d} ~ wwxYw) u 이미지 파일을 Meta 광고 이미지로 업로드하고 hash를 반환한다. Args: image_path: 업로드할 이미지 파일의 절대/상대 경로 Returns: str: 업로드된 이미지의 hash 값 u-이미지 파일을 찾을 수 없습니다: rimageshashrXu(이미지 업로드 완료: %s (hash=%s)u#이미지 업로드 실패 (%s): %sN)rrYFileNotFoundErrorrrtfilenamestrr)create_ad_imager>nextiterr"r*r+rur rH) r,rrbrFimagerPinner first_key image_hashr}s r0 upload_imagezMetaAdsClient.upload_imagesJ{{}#&ST^S_$`a a--((#d)4 MM11F1KE=='D4X e- Y'&"-J KKBDIIz Z #  LL> 1 M  sBC D"DDrpage_idmessagelinkc||d}|r||d<||d}tjj|tjj|i} |jj g|} |j | } tjd| jd|| S#t$r} tjd| d} ~ wwxYw) uw 광고 크리에이티브를 생성한다. Args: name: 크리에이티브 이름 image_hash: 업로드된 이미지의 hash 값 page_id: 페이스북 페이지 ID message: 광고 본문 텍스트 link: 연결할 URL (선택) Returns: dict: 생성된 AdCreative 정보 )rrr)r link_dataru6광고 크리에이티브 생성 완료: id=%s name=%sru+광고 크리에이티브 생성 실패: %sN) rrtruobject_story_specr)create_ad_creativer>r*r+r"r rH) r,rurrrrrrrFcreativeror}s r0create_creativezMetaAdsClient.create_creatives,$%   $If "     ! !4    . .0A"  }}77r&7QH]]8,F KKPRXR\R\]aRbdh iM#  LLF J  s AB C(B??C object_id object_type date_preset time_rangec|t}i}|r||d<n |r||d<nd|d< |j}|dk(r t|}n1|dk(r t|}n |dk(r t |}nt d|d |j || } t| D cgc]} |j| } } tjd t| ||| Scc} w#t$r} tjd ||| d} ~ wwxYw) u 광고 성과 인사이트를 반환한다. Args: object_id: 조회할 캠페인/광고세트/광고 ID object_type: 'campaign', 'adset', 'ad' 중 하나 (기본값: 'campaign') fields: 반환할 필드 목록. None이면 기본 필드 사용. date_preset: 기간 프리셋 (예: 'last_7d', 'last_30d', 'today'). time_range와 동시 사용 불가. time_range: 기간 dict (예: {"since": "2024-01-01", "until": "2024-01-31"}). date_preset과 동시 사용 불가. Returns: list[dict]: 인사이트 레코드 목록 Nrrlast_7drradu!지원하지 않는 object_type: u7. 'campaign', 'adset', 'ad' 중 하나여야 합니다.ru9인사이트 조회 완료: %d건 (object_type=%s, id=%s)u6인사이트 조회 실패 (object_type=%s, id=%s): %s)_DEFAULT_INSIGHT_FIELDSlowerr r rr# get_insightsrr>r*r7rr rH) r,rrrsrrrFobj_type_lowertargetinsightsiror}s r0rzMetaAdsClient.get_insightsMs$. >,F!# $/F= ! #-F< $-F= ! (..0N+!),7*y)4'I 7 }D{|**&*HH04X?1dmmA&?F? LLKF    M@$  LLQS^`ikl m  s*A2CC+$CC C<C77C<)N)N)PAUSEDNN)NNr)r)rNNN)__name__ __module__ __qualname____doc___ENV_KEYS_PATHrr1r( staticmethodrr=r>rRrjrpr~rintrrrrboolrrrrrrrrr8r0rr,s,,:[c[t[J888C8D8 cd""H%Q#%Q$%QNT4$>$(#S D ## d #P$(  S D    L#'26 %%% % Dj % $Cy4/ % %N3#$(340#'#' (4Z(S D ( ( d (d))) )  )  ))) )VSCD(ST,ssH ,,, ,  , Dj , ,j&#'"&"& :::S D : 4Z : 4K : d:r8r)!rr pathlibrtypingrrKfacebook_business.adobjects.adr%facebook_business.adobjects.adaccountr&facebook_business.adobjects.adcreativer#facebook_business.adobjects.adimager!facebook_business.adobjects.adsetr $facebook_business.adobjects.campaignr facebook_business.apir facebook_business.exceptionsr utils.env_loaderr utils.loggerrrr*rJrrrrr8r0rs^ -;=7390=*# H 40[ [ r8