Add more metric for low level API usage

.env

@@ -1,5 +1,7 @@
-fb_user_access_token=
-fb_app_id=
-fb_app_secret=
-fb_default_page_id=
+fb_user_access_token=EAAPzLwL9ZA20BAFf9SxcVMwt6q0PKQQjpDv7Tny6T4gFVepZBZCGhgUTEqe5m1Y8Ial1fQFVqCyRpuoeD2pQTRP2gJg24BHzN3qOqnsNAZBgDYUBFkkw4ZAufpHme1kSjAiasYBv2LHSIeDF3wHZCvqprc7nkK4rW0XeZCPZBLACTHGySZCZADMeND3KumZCuoeZB7QZD
+fb_app_id=1111808169305965
+fb_app_secret=72d5258eaec14dbf0e09dff5b961b2db
+fb_default_page_id=160712400714277
 fb_default_page_access_token=
+GOOGLE_APPLICATION_CREDENTIALS=./service-account.json
+BIGQUERY_PROJECT=pycontw-225217

README.md

@@ -1,16 +1,18 @@
 # Python Facebook Page Insights Client
 
+Currently, it is used by https://github.com/pycontw/pycon-etl
+
 ## Usage
 
 ## Get needed secrets first
 
 https://github.com/facebook/facebook-python-business-sdk#register-an-app is a reference and the steps are 
 1. create a FB app and get its `app_id` and `secret`, 
-2. In terms of `user_access_token`, make sure you are a registered developer of this fb app and get user access token on Graph Explorer. You will get a short-term user_token by default, expired in 2 or 3 months. To get long-term token, choose either of the below ways
-    - using Graph Exploer -> Access token tool -> Extend access token
-    - invoke get_long_lived_user_token of this library 
+2. In terms of `user_access_token/page_access_token`, make sure you are a registered developer of this fb app, and get user_access_token or page_user_token on Graph Explorer with selected scopes, read_insights & pages_read_engagement. Either user_token or page_token is working. You will get a short-term token by default, expired in 2 or 3 months. To get long-term token, choose either of the below ways
+    - this library will automatically get the long-lived token and cache it in local db.json
+    - manually use Graph Exploer -> Access token tool -> Extend access token to get long-lived token first.
 
-Rather than Graph Explorer, https://github.com/pycontw/python-fb-page-insights-client/issues/6 introduces another way which does not to be a registered developer of this fb app. But this way is not recommanded. 
+Rather than Graph Explorer, https://github.com/pycontw/python-fb-page-insights-client/issues/6 introduces another way which does not to be a registered developer of this fb app. But this way is not recommended. 
 
 ### Pass secrets 
 
@@ -25,11 +27,13 @@ fb_default_page_access_token=
 ```
 
 You can choose any of below ways:
-- pass them as function paramets
-- manually export them as enviornments variables
+- pass them as function parameters
+- manually export them as environment variables
 - create a .env to include them
 
-if fb_user_access_token is filled, fb_default_page_access_token is not necessary and will be ignored. fb_user_access_token will be used to get page token internally. 
+if fb_default_page_access_token is filled and valid, fb_user_access_token usage will be skipped. fb_user_access_token is used to get page token internally. So you only need to fill either a valid fb_default_page_access_token or fb_user_access_token.
+
+You can skip fb_app_id and fb_app_secret if you are sure if fb_user_access_token/fb_default_page_access_token is long-lived token. In https://developers.facebook.com/tools/debug/accesstoken/, You can paste the token to check its "Expires" and "Valid" field.
 
 ## Fetch data 
 
@@ -44,10 +48,6 @@ Use `FBPageInsight` class to fetch. Please checkout the unit test code as an exa
         - `Calls within one hour = 4800 * Number of Engaged Users`
         - api response header inclues `x-business-use-case-usage`
 
-### Somehow FB will return invalid data sometimes 
-
-FB API is not very stable and plrease try again. 
-
 ## Development
 
 1. `poetry shell`
@@ -67,3 +67,4 @@ Two methods:
 ## TODO:
 
 https://github.com/pycontw/python-fb-page-insights-client/discussions/4
+

pyproject.toml

@@ -9,6 +9,7 @@ python = "^3.7.1"
 pydantic = "^1.8.2"
 requests = "^2.25.1"
 python-dotenv = "^0.18.0"
+tinydb = "^4.5.1"
 
 [tool.poetry.dev-dependencies]
 autopep8 = "^1.5.7"