Work4Labs · jolancornevin · Sep 13, 2023 · Sep 13, 2023 · Sep 14, 2023 · Sep 14, 2023
diff --git a/.circleci/config.yml b/.circleci/config.yml
@@ -3,26 +3,25 @@
 version: 2
 
 shared: &shared
-    steps:
-      - checkout
-      # Define config in CircleCi's project settings → Environment Variables
-      - run: echo \{\"app_id\":\"$FB_APP_ID\",\"app_secret\":\"$FB_APP_SECRET\",\"act_id\":\"act_$FB_ACCOUNT_ID\",\"page_id\":\"$FB_PAGE_ID\",\"access_token\":\"$FB_ACCESS_TOKEN\",\"business\":\"$FB_BUSINESS_ID\",\"sec_business\":\"$FB_BUSINESS_ID_BIS\",\"sec_act_id\":\"act_$FB_ACCOUNT_ID_BIS\"\} > config.json
-      # Cheapo virtualenv, CCi images use the circleci user so no writing to the root site-packages
-      - run: virtualenv venv
-      - run: venv/bin/python setup.py install
-      - run: venv/bin/python -m facebook_business.test.unit
+  steps:
+    - checkout
+    # Define config in CircleCi's project settings → Environment Variables
+    - run: echo \{\"app_id\":\"$FB_APP_ID\",\"app_secret\":\"$FB_APP_SECRET\",\"act_id\":\"act_$FB_ACCOUNT_ID\",\"page_id\":\"$FB_PAGE_ID\",\"access_token\":\"$FB_ACCESS_TOKEN\",\"business\":\"$FB_BUSINESS_ID\",\"sec_business\":\"$FB_BUSINESS_ID_BIS\",\"sec_act_id\":\"act_$FB_ACCOUNT_ID_BIS\"\} > config.json
+    # Cheapo virtualenv, CCi images use the circleci user so no writing to the root site-packages
+    - run: pip install --no-cache-dir virtualenv && virtualenv venv3
+    - run: virtualenv venv
+    - run: venv/bin/python setup.py install
+    - run: venv/bin/python -m facebook_business.test.unit
 
 jobs:
-  python-3.7:  # Not specified in tox.ini
+  python-3.10: # Not specified in tox.ini
     <<: *shared
     docker:
-      - image: circleci/python:3.7-stretch-node
-
-
+      - image: python:3.7-buster
 
 all_jobs: &all_jobs
-    jobs:
-      - python-3.7
+  jobs:
+    - python-3.10
 
 workflows:
   version: 2

diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,18 @@
+Copyright (c) Meta Platforms, Inc. and affiliates.
+All rights reserved.
+
+You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
+copy, modify, and distribute this software in source code or binary form for use
+in connection with the web services and APIs provided by Facebook.
+
+As with any software that integrates with the Facebook platform, your use of
+this software is subject to the Facebook Platform Policy
+[http://developers.facebook.com/policy/]. This copyright notice shall be
+included in all copies or substantial portions of the software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/LICENSE.txt b/LICENSE.txt
diff --git a/README.md b/README.md
@@ -170,7 +170,7 @@ API using a specific api object instead of the default, you can specify the
 ### Edges
 
 Look at the methods of an object to see what associations over which we can
-iterate. For example an ``AdUser`` object has a method ``get_ad_accounts`` which
+iterate. For example an ``User`` object has a method ``get_ad_accounts`` which
 returns an iterator of ``AdAccount`` objects.
 
 ### Ad Account
@@ -183,7 +183,8 @@ Let's get all the ad accounts for the user with the given access token. I only
 have one account so the following is printed:
 
 ```python
->>> me = adobjects.AdUser(fbid='me')
+>>> from facebook_business.adobjects.user import User
+>>> me = adobjects.User(fbid='me')
 >>> my_accounts = list(me.get_ad_accounts())
 >>> print(my_accounts)
 [{   'account_id': u'17842443', 'id': u'act_17842443'}]
@@ -192,7 +193,7 @@ have one account so the following is printed:
 ```
 
 **WARNING**: We do not specify a keyword argument ``api=api`` when instantiating
-the ``AdUser`` object here because we've already set the default api when
+the ``User`` object here because we've already set the default api when
 bootstrapping.
 
 **NOTE**: We wrap the return value of ``get_ad_accounts`` with ``list()``

diff --git a/examples/AdAccountAdSetsPostAdSetCreateCpa.py b/examples/AdAccountAdSetsPostAdSetCreateCpa.py
@@ -35,8 +35,8 @@
   'name': 'A CPA Ad Set',
   'campaign_id': '<adCampaignLinkClicksID>',
   'daily_budget': '5000',
-  'start_time': '2023-04-24T09:25:05-0700',
-  'end_time': '2023-05-01T09:25:05-0700',
+  'start_time': '2024-06-18T16:39:15-0700',
+  'end_time': '2024-06-25T16:39:15-0700',
   'billing_event': 'IMPRESSIONS',
   'optimization_goal': 'REACH',
   'bid_amount': '1000',

diff --git a/examples/AdAccountAdSetsPostAdSetCreateCpaAppEvents.py b/examples/AdAccountAdSetsPostAdSetCreateCpaAppEvents.py
@@ -35,8 +35,8 @@
   'name': 'A CPA Ad Set optimized for App Events',
   'campaign_id': '<adCampaignAppInstallsID>',
   'daily_budget': '300',
-  'start_time': '2023-04-24T09:25:55-0700',
-  'end_time': '2023-05-01T09:25:55-0700',
+  'start_time': '2024-06-18T16:40:02-0700',
+  'end_time': '2024-06-25T16:40:02-0700',
   'billing_event': 'IMPRESSIONS',
   'optimization_goal': 'OFFSITE_CONVERSIONS',
   'bid_amount': '100',

diff --git a/examples/AdAccountAdSetsPostCreateAdSet.py b/examples/AdAccountAdSetsPostCreateAdSet.py
@@ -34,8 +34,8 @@
 params = {
   'name': 'My First AdSet',
   'lifetime_budget': '20000',
-  'start_time': '2023-04-24T09:24:18-0700',
-  'end_time': '2023-05-01T09:24:18-0700',
+  'start_time': '2024-06-18T16:38:30-0700',
+  'end_time': '2024-06-25T16:38:30-0700',
   'campaign_id': '<adCampaignLinkClicksID>',
   'bid_amount': '500',
   'billing_event': 'IMPRESSIONS',

diff --git a/examples/AdAccountAdSetsPostDailyBudget20.py b/examples/AdAccountAdSetsPostDailyBudget20.py
@@ -34,8 +34,8 @@
 params = {
   'name': 'My First Adset',
   'daily_budget': '2000',
-  'start_time': '2023-04-17T09:25:24-0700',
-  'end_time': '2023-04-24T09:25:24-0700',
+  'start_time': '2024-06-11T16:39:34-0700',
+  'end_time': '2024-06-18T16:39:34-0700',
   'campaign_id': '<adCampaignLinkClicksID>',
   'bid_amount': '100',
   'billing_event': 'LINK_CLICKS',

diff --git a/examples/AdAccountAdSetsPostLifetimeBudget200Duration10Days.py b/examples/AdAccountAdSetsPostLifetimeBudget200Duration10Days.py
@@ -34,8 +34,8 @@
 params = {
   'name': 'My First Adset',
   'lifetime_budget': '20000',
-  'start_time': '2023-04-17T09:25:36-0700',
-  'end_time': '2023-04-27T09:25:36-0700',
+  'start_time': '2024-06-11T16:39:43-0700',
+  'end_time': '2024-06-21T16:39:43-0700',
   'campaign_id': '<adCampaignLinkClicksID>',
   'bid_amount': '100',
   'billing_event': 'LINK_CLICKS',

diff --git a/examples/AdAccountAdSetsPostOptimizePostEngagement.py b/examples/AdAccountAdSetsPostOptimizePostEngagement.py
@@ -34,8 +34,8 @@
 params = {
   'name': 'My First Adset',
   'lifetime_budget': '20000',
-  'start_time': '2023-04-17T09:25:45-0700',
-  'end_time': '2023-04-27T09:25:45-0700',
+  'start_time': '2024-06-11T16:39:52-0700',
+  'end_time': '2024-06-21T16:39:52-0700',
   'campaign_id': '<adCampaignLinkClicksID>',
   'bid_amount': '500',
   'billing_event': 'IMPRESSIONS',

diff --git a/examples/AdgroupLeadsEdgeAdgroupLeadsFiltered.py b/examples/AdgroupLeadsEdgeAdgroupLeadsFiltered.py
@@ -32,7 +32,7 @@
 fields = [
 ]
 params = {
-  'filtering': [{'field':'time_created','operator':'GREATER_THAN','value':1681144509}],
+  'filtering': [{'field':'time_created','operator':'GREATER_THAN','value':1717544918}],
 }
 print Ad(id).get_leads(
   fields=fields,

diff --git a/examples/AdsPixelEventsPost.py b/examples/AdsPixelEventsPost.py
@@ -31,7 +31,7 @@
 fields = [
 ]
 params = {
-  'data': [{'event_name':'PageView','event_time':1681748568,'user_data':{'fbc':'fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890','fbp':'fb.1.1558571054389.1098115397','em':'309a0a5c3e211326ae75ca18196d301a9bdbd1a882a4d2569511033da23f0abd'}}],
+  'data': [{'event_name':'PageView','event_time':1718149023,'user_data':{'fbc':'fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890','fbp':'fb.1.1558571054389.1098115397','em':'309a0a5c3e211326ae75ca18196d301a9bdbd1a882a4d2569511033da23f0abd'}}],
 }
 print AdsPixel(id).create_event(
   fields=fields,

diff --git a/examples/ProductCatalogHotelsPostUpdateHotelsCatalogSettings.py b/examples/ProductCatalogHotelsPostUpdateHotelsCatalogSettings.py
@@ -31,7 +31,6 @@
 fields = [
 ]
 params = {
-  'hotel_catalog_settings': {'pull_config_id':'<pullConfigID>'},
 }
 print ProductCatalog(id).update(
   fields=fields,

diff --git a/examples/async.py b/examples/async.py
@@ -33,9 +33,8 @@
 
 this_dir = os.path.dirname(__file__)
 config_filename = os.path.join(this_dir, 'config.json')
-config_file = open(config_filename)
-config = json.load(config_file)
-config_file.close()
+with open(config_filename) as config_file:
+    config = json.load(config_file)
 
 api = FacebookAdsApi.init(access_token=config['access_token'])
 account_id = config['act_id']

diff --git a/examples/batch_create.py b/examples/batch_create.py
@@ -22,6 +22,7 @@
 Creates several ads using batch calls.
 """
 
+
 from facebook_business import FacebookSession
 from facebook_business import FacebookAdsApi
 from facebook_business.adobjects.adaccount import AdAccount
@@ -35,9 +36,8 @@
 this_dir = os.path.dirname(__file__)
 config_filename = os.path.join(this_dir, 'config.json')
 
-config_file = open(config_filename)
-config = json.load(config_file)
-config_file.close()
+with open(config_filename) as config_file:
+    config = json.load(config_file)
 
 ### Setup session and api objects
 session = FacebookSession(

diff --git a/examples/batch_pause.py b/examples/batch_pause.py
@@ -22,6 +22,7 @@
 Pauses all active ad campaigns using batch calls.
 """
 
+
 from facebook_business import FacebookSession
 from facebook_business import FacebookAdsApi
 from facebook_business.adobjects.adaccount import AdAccount
@@ -35,9 +36,8 @@
 this_dir = os.path.dirname(__file__)
 config_filename = os.path.join(this_dir, 'config.json')
 
-config_file = open(config_filename)
-config = json.load(config_file)
-config_file.close()
+with open(config_filename) as config_file:
+    config = json.load(config_file)
 
 ### Setup session and api objects
 session = FacebookSession(

diff --git a/examples/custom_audience_utils.py b/examples/custom_audience_utils.py
@@ -24,6 +24,7 @@
 https://github.com/facebook/facebook-python-ads-sdk
 """
 
+
 from facebook_business import FacebookAdsApi
 from facebook_business.adobjects.adaccount import AdAccount
 from facebook_business.adobjects.customaudience import CustomAudience
@@ -38,10 +39,8 @@
 this_dir = os.path.dirname(__file__)
 config_filename = os.path.join(this_dir, 'config.json')
 
-### Setup session and api objects
-config_file = open(config_filename)
-config = json.load(config_file)
-config_file.close()
+with open(config_filename) as config_file:
+    config = json.load(config_file)
 
 auth_info = (
     config['app_id'],

diff --git a/examples/dpa-update/dpa_search.py b/examples/dpa-update/dpa_search.py
@@ -29,9 +29,8 @@
 import sys
 sys.path.insert(1, os.path.join(this_dir, os.pardir, os.pardir))
 
-config_file = open(config_filename)
-config = json.load(config_file)
-config_file.close()
+with open(config_filename) as config_file:
+    config = json.load(config_file)
 
 from facebook_business.api import FacebookAdsApi
 from facebook_business.adobjects.productcatalog import ProductCatalog

diff --git a/examples/dpa-update/dpa_update.py b/examples/dpa-update/dpa_update.py
@@ -30,9 +30,8 @@
 import sys
 sys.path.insert(1, os.path.join(this_dir, os.pardir, os.pardir))
 
-config_file = open(config_filename)
-config = json.load(config_file)
-config_file.close()
+with open(config_filename) as config_file:
+    config = json.load(config_file)
 
 from facebook_business.api import FacebookAdsApi
 from facebook_business.adobjects.productcatalog import ProductCatalog

diff --git a/examples/read_objects.py b/examples/read_objects.py
@@ -22,6 +22,7 @@
 Prints account permissions and campaign statistics.
 """
 
+
 from facebook_business import FacebookSession
 from facebook_business import FacebookAdsApi
 from facebook_business.adobjects.campaign import Campaign as AdCampaign
@@ -35,9 +36,8 @@
 this_dir = os.path.dirname(__file__)
 config_filename = os.path.join(this_dir, 'config.json')
 
-config_file = open(config_filename)
-config = json.load(config_file)
-config_file.close()
+with open(config_filename) as config_file:
+    config = json.load(config_file)
 
 ### Setup session and api objects
 session = FacebookSession(

diff --git a/examples/simple_create.py b/examples/simple_create.py
@@ -22,6 +22,7 @@
 Creates an ad through a utility function.
 """
 
+
 from facebook_business import FacebookSession
 from facebook_business import FacebookAdsApi
 from facebook_business.adobjects.adaccount import AdAccount
@@ -36,9 +37,8 @@
 this_dir = os.path.dirname(__file__)
 config_filename = os.path.join(this_dir, 'config.json')
 
-config_file = open(config_filename)
-config = json.load(config_file)
-config_file.close()
+with open(config_filename) as config_file:
+    config = json.load(config_file)
 
 ### Setup session and api objects
 session = FacebookSession(
@@ -88,10 +88,9 @@
         'ad_format': AdPreview.AdFormat.right_column_standard
     })
     preview_filename = os.path.join(this_dir, 'preview_ad.html')
-    preview_file = open(preview_filename, 'w')
-    preview_file.write(
-        "<html><head><title>Facebook Ad Preview</title><body>%s</body></html>"
-        % preview.get_html()
-    )
-    preview_file.close()
+    with open(preview_filename, 'w') as preview_file:
+        preview_file.write(
+            "<html><head><title>Facebook Ad Preview</title><body>%s</body></html>"
+            % preview.get_html()
+        )
     print('**** %s has been created!' % preview_filename)
diff --git a/examples/upload_video.py b/examples/upload_video.py
@@ -22,6 +22,7 @@
 Upload a video to adaccount
 """
 
+
 import sys
 import os
 
@@ -34,9 +35,8 @@
 
 config_filename = os.path.join(sdk_path, './config.json')
 
-config_file = open(config_filename)
-config = json.load(config_file)
-config_file.close()
+with open(config_filename) as config_file:
+    config = json.load(config_file)
 
 ### Setup session and api objects
 session = FacebookSession(