python-amazon-ad-api 0.4.3__tar.gz → 0.4.5__tar.gz

{python-amazon-ad-api-0.4.3 → python-amazon-ad-api-0.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-amazon-ad-api
-Version: 0.4.3
+Version: 0.4.5
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -299,21 +299,21 @@ There is a new version 3 of Sponsored Product API, please check the [migration g
 
 ### [Modules Available Sponsored Brands 3.0](https://python-amazon-ad-api.readthedocs.io/en/latest/sb_v3.html)
 
-* Campaigns(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/campaigns.html)
-* Ad Groups(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/ad_groups.html)
-* Keywords(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/keywords.html)
-* Negative Keywords(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/negative_keywords.html)
-* Product Targeting(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/product_targeting.html)
-* Negative Product Targeting(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/negative_product_targeting.html)
-* Targeting Recommendations(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/targeting_recommendations.html)
-* Bid Recommendations(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/bid_recommendations.html)
-* Stores(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/stores.html)
-* Landing Page Asins(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/landing_page_asins.html)
-* Media(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/media.html)
-* Brands(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/brands.html)
-* Moderation(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/moderation.html)
-* Reports(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/reports.html)
-* Snapshots
+* [Campaigns](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/campaigns.html)
+* [Ad Groups](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/ad_groups.html)
+* [Keywords](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/keywords.html)
+* [Negative Keywords](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/negative_keywords.html)
+* [Product Targeting](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/product_targeting.html)
+* [Negative Product Targeting](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/negative_product_targeting.html)
+* [Targeting Recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/targeting_recommendations.html)
+* [Bid Recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/bid_recommendations.html)
+* [Stores](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/stores.html)
+* [Landing Page Asins](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/landing_page_asins.html)
+* [Media](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/media.html)
+* [Brands](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/brands.html)
+* [Moderation](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/moderation.html)
+* [Reports](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/reports.html)
+* [Snapshots](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/snapshots.html)
 
 ### [Modules Available Sponsored Brands 4.0](https://python-amazon-ad-api.readthedocs.io/en/latest/sb_v4.html)
 
@@ -338,9 +338,9 @@ There is a new version 3 of Sponsored Product API, please check the [migration g
 * [Forecasts](https://python-amazon-ad-api.readthedocs.io/en/latest/sd/forecast.html)
 * [Recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/sd/recommendations.html)
 
-### Modules Available DSP
+### [Modules Available DSP](https://python-amazon-ad-api.readthedocs.io/en/latest/dsp.html)
 
-* Reports
+* [Reports](https://python-amazon-ad-api.readthedocs.io/en/latest/dsp/reports.html)
 
 ### Simple Example Usage Campaigns with Credentials
 

{python-amazon-ad-api-0.4.3 → python-amazon-ad-api-0.4.5}/README.md

@@ -284,21 +284,21 @@ There is a new version 3 of Sponsored Product API, please check the [migration g
 
 ### [Modules Available Sponsored Brands 3.0](https://python-amazon-ad-api.readthedocs.io/en/latest/sb_v3.html)
 
-* Campaigns(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/campaigns.html)
-* Ad Groups(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/ad_groups.html)
-* Keywords(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/keywords.html)
-* Negative Keywords(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/negative_keywords.html)
-* Product Targeting(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/product_targeting.html)
-* Negative Product Targeting(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/negative_product_targeting.html)
-* Targeting Recommendations(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/targeting_recommendations.html)
-* Bid Recommendations(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/bid_recommendations.html)
-* Stores(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/stores.html)
-* Landing Page Asins(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/landing_page_asins.html)
-* Media(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/media.html)
-* Brands(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/brands.html)
-* Moderation(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/moderation.html)
-* Reports(https://python-amazon-ad-api.readthedocs.io/en/latest/sb/reports.html)
-* Snapshots
+* [Campaigns](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/campaigns.html)
+* [Ad Groups](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/ad_groups.html)
+* [Keywords](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/keywords.html)
+* [Negative Keywords](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/negative_keywords.html)
+* [Product Targeting](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/product_targeting.html)
+* [Negative Product Targeting](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/negative_product_targeting.html)
+* [Targeting Recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/targeting_recommendations.html)
+* [Bid Recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/bid_recommendations.html)
+* [Stores](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/stores.html)
+* [Landing Page Asins](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/landing_page_asins.html)
+* [Media](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/media.html)
+* [Brands](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/brands.html)
+* [Moderation](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/moderation.html)
+* [Reports](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/reports.html)
+* [Snapshots](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/snapshots.html)
 
 ### [Modules Available Sponsored Brands 4.0](https://python-amazon-ad-api.readthedocs.io/en/latest/sb_v4.html)
 
@@ -323,9 +323,9 @@ There is a new version 3 of Sponsored Product API, please check the [migration g
 * [Forecasts](https://python-amazon-ad-api.readthedocs.io/en/latest/sd/forecast.html)
 * [Recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/sd/recommendations.html)
 
-### Modules Available DSP
+### [Modules Available DSP](https://python-amazon-ad-api.readthedocs.io/en/latest/dsp.html)
 
-* Reports
+* [Reports](https://python-amazon-ad-api.readthedocs.io/en/latest/dsp/reports.html)
 
 ### Simple Example Usage Campaigns with Credentials
 

{python-amazon-ad-api-0.4.3 → python-amazon-ad-api-0.4.5}/ad_api/api/dsp/client.py

@@ -1,14 +1,7 @@
 from ad_api.base import Client
-from ad_api.auth.credentials import BaseCredentials
-from ad_api.api.dsp.credential_provider import DspCredentialProvider
-from ad_api.api.dsp.access_token_client import DspAccessTokenClient
 
 
 class DspClient(Client):
-    access_token_client_class = DspAccessTokenClient
-    credentials_class = BaseCredentials
-    credential_provider_class = DspCredentialProvider
-
     @property
     def headers(self):
         return {

{python-amazon-ad-api-0.4.3 → python-amazon-ad-api-0.4.5}/ad_api/api/reports.py

@@ -1,4 +1,4 @@
-from ad_api.base import Client, sp_endpoint, fill_query_params, ApiResponse
+from ad_api.base import Client, sp_endpoint, fill_query_params, ApiResponse, Utils
 
 
 class Reports(Client):
@@ -35,7 +35,7 @@ class Reports(Client):
             ApiResponse
 
         """
-        return self._request(kwargs.pop('path'), data=kwargs.pop('body'), params=kwargs)
+        return self._request(kwargs.pop('path'), data=Utils.convert_body(kwargs.pop('body'), False), params=kwargs)
 
     @sp_endpoint('/reporting/reports/{}', method='GET')
     def get_report(self, reportId, **kwargs) -> ApiResponse:

{python-amazon-ad-api-0.4.3 → python-amazon-ad-api-0.4.5}/ad_api/api/sp/keywords_v3.py

@@ -13,7 +13,7 @@ class KeywordsV3(Client):
         Returns
             ApiResponse
         """
-        json_version = 'application/vnd.spKeyword.v3+json' + str(version) + "+json"
+        json_version = 'application/vnd.spKeyword.v' + str(version) + "+json"
         headers = {
             "Accept": json_version,
             "Content-Type": json_version
@@ -39,7 +39,7 @@ class KeywordsV3(Client):
         Returns
             ApiResponse
         """
-        json_version = 'application/vnd.spKeyword.v3+json' + str(version) + "+json"
+        json_version = 'application/vnd.spKeyword.v' + str(version) + "+json"
 
         headers = {
             "Accept": json_version,
@@ -67,7 +67,7 @@ class KeywordsV3(Client):
             ApiResponse
         """
 
-        json_version = 'application/vnd.spKeyword.v3+json' + str(version) + "+json"
+        json_version = 'application/vnd.spKeyword.v' + str(version) + "+json"
         headers = {
             "Accept": json_version,
             "Content-Type": json_version
@@ -93,7 +93,7 @@ class KeywordsV3(Client):
             ApiResponse
         """
 
-        json_version = 'application/vnd.spKeyword.v3+json' + str(version) + "+json"
+        json_version = 'application/vnd.spKeyword.v' + str(version) + "+json"
         headers = {
             "Accept": json_version,
             "Content-Type": json_version

{python-amazon-ad-api-0.4.3 → python-amazon-ad-api-0.4.5}/ad_api/api/sp/product_ads_v3.py

@@ -25,7 +25,7 @@ class ProductAdsV3(Client):
             ApiResponse
         """
 
-        json_version = 'application/vnd.spCampaign.v' + str(version) + "+json"
+        json_version = 'application/vnd.spproductAd.v' + str(version) + "+json"
 
         headers = {
             "Accept": json_version,

{python-amazon-ad-api-0.4.3 → python-amazon-ad-api-0.4.5}/ad_api/auth/access_token_client.py

@@ -7,6 +7,8 @@ from ad_api.base import BaseClient
 from .credentials import Credentials
 from .access_token_response import AccessTokenResponse
 from .exceptions import AuthorizationError
+# from .credential_provider import CredentialProvider
+
 import os
 
 cache = TTLCache(maxsize=int(os.environ.get('AD_API_AUTH_CACHE_SIZE', 10)), ttl=3200)
@@ -20,9 +22,9 @@ class AccessTokenClient(BaseClient):
     grant_type = 'refresh_token'
     path = '/auth/o2/token'
 
-    def __init__(self, account='default', credentials=None, credentials_class=Credentials, proxies=None, verify=True, timeout=None):
-        super().__init__(account, credentials)
-        self.cred = credentials_class(self.credentials)
+    def __init__(self, credentials=None, proxies=None, verify=True, timeout=None):
+
+        self.cred = Credentials(credentials)
         self.timeout = timeout
         self.proxies = proxies
         self.verify = verify

python-amazon-ad-api-0.4.5/ad_api/auth/credentials.py

@@ -0,0 +1,6 @@
+class Credentials:
+    def __init__(self, credentials):
+        self.client_id = credentials['client_id']
+        self.client_secret = credentials['client_secret']
+        self.refresh_token = credentials['refresh_token']
+        self.profile_id = credentials['profile_id']

{python-amazon-ad-api-0.4.3 → python-amazon-ad-api-0.4.5}/ad_api/base/base_client.py

@@ -1,18 +1,14 @@
 import ad_api.version as vd
-from ad_api.base.credential_provider import CredentialProvider
-
 
 class BaseClient:
     scheme = 'https://'
     method = 'GET'
     content_type = 'application/x-www-form-urlencoded;charset=UTF-8'
     user_agent = 'python-ad-api'
-    credential_provider_class = CredentialProvider
 
-    def __init__(self, account='default', credentials=None):
+    def __init__(self):
         try:
             version = vd.__version__
             self.user_agent += f'-{version}'
         except:
             pass
-        self.credentials = self.credential_provider_class(account, credentials).credentials

{python-amazon-ad-api-0.4.3 → python-amazon-ad-api-0.4.5}/ad_api/base/client.py

@@ -1,4 +1,5 @@
 import json
+from json import JSONDecodeError
 import logging
 from cachetools import TTLCache
 from requests import request
@@ -6,7 +7,7 @@ from ad_api.auth.credentials import Credentials
 from ad_api.auth import AccessTokenClient, AccessTokenResponse
 from .api_response import ApiResponse
 from .base_client import BaseClient
-from .exceptions import get_exception_for_content
+from .exceptions import get_exception_for_code, get_exception_for_content
 from .marketplaces import Marketplaces
 import os
 import requests
@@ -15,15 +16,13 @@ import gzip
 from zipfile import ZipFile
 import zipfile
 from urllib.parse import urlparse, quote
+from ad_api.base.credential_provider import CredentialProvider
 
 log = logging.getLogger(__name__)
 role_cache = TTLCache(maxsize=int(os.environ.get('AD_API_AUTH_CACHE_SIZE', 10)), ttl=3200)
 
 
 class Client(BaseClient):
-    access_token_client_class = AccessTokenClient
-    credentials_class = Credentials
-    grantless_scope = ''
 
     def __init__(
             self,
@@ -37,17 +36,15 @@ class Client(BaseClient):
             debug=False
     ):
 
-        super().__init__(account, credentials)
-        self.endpoint = marketplace.endpoint
-        self.debug = debug
-        self._auth = self.access_token_client_class(
-            account=account,
-            credentials=credentials,
-            credentials_class=self.credentials_class,
+        self.credentials = CredentialProvider(account, credentials).credentials
+        self._auth = AccessTokenClient(
+            credentials=self.credentials,
             proxies=proxies,
             verify=verify,
             timeout=timeout,
         )
+        self.endpoint = marketplace.endpoint
+        self.debug = debug
         self.timeout = timeout
         self.proxies = proxies
         self.verify = verify
@@ -56,9 +53,9 @@ class Client(BaseClient):
     def headers(self):
         return {
             'User-Agent': self.user_agent,
-            'Amazon-Advertising-API-ClientId': self.credentials.client_id,
+            'Amazon-Advertising-API-ClientId': self.credentials['client_id'],
             'Authorization': 'Bearer %s' % self.auth.access_token,
-            'Amazon-Advertising-API-Scope': self.credentials.profile_id,
+            'Amazon-Advertising-API-Scope': self.credentials['profile_id'],
             'Content-Type': 'application/json'
         }
 
@@ -263,6 +260,7 @@ class Client(BaseClient):
         if self.debug:
             logging.info(headers or self.headers)
 
+
             if params:
                 str_query = ""
                 for key, value in params.items():
@@ -275,69 +273,48 @@ class Client(BaseClient):
             if data is not None:
                 logging.info(data)
 
-        return self._check_response(res)
+            logging.info(vars(res))
 
-    # @staticmethod
-    def _check_response(self, res) -> ApiResponse:
+        return self._check_response(res)
 
-        if self.debug:
-            logging.info(vars(res))
+    @staticmethod
+    def _check_response(res) -> ApiResponse:
 
         content = vars(res).get('_content')
-        str_content = content.decode('utf8')
+        headers = vars(res).get('headers')
+        status_code = vars(res).get('status_code')
 
-        if type(str_content) is str and str_content[0:50] == '<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">' and vars(res).get('_content_consumed') is True:
+        if 200 <= res.status_code < 300:
 
-            dictionary = {"status_code": vars(res).get('status_code'), "msg": "Unauthorized"}
-            exception = get_exception_for_content(dictionary)
-            raise exception(dictionary)
+            try:
+                js = res.json() or {}
+            except JSONDecodeError:
+                js = {}
 
-        if type(str_content) is str and str_content[0:15] == 'Invalid request' and vars(res).get('_content_consumed') is True:
-            dictionary = {"status_code": vars(res).get('status_code'), "msg": str_content}
-            exception = get_exception_for_content(dictionary)
-            raise exception(dictionary)
+            try:
+                error = js.get('error', None) # Dict.get(key, default=None)
+            except AttributeError:
+                error = None
 
-        data = json.loads(str_content)
+            if error:
+                exception = get_exception_for_content(error[0].get('code'))
+                raise exception(error[0].get('code'), error[0], headers)
 
-        if type(data) is dict and data.get('code') == 'UNAUTHORIZED':
-            exception = get_exception_for_content(data)
-            raise exception(data)
+            next_token = vars(res).get('_next')
 
-        if type(data) is dict and data.get('message') == 'Too Many Requests' and vars(res).get('_content_consumed') is True:
-            exception = get_exception_for_content(data)
-            raise exception(data)
+            return ApiResponse(js, next_token, headers=headers)
 
-        if type(data) is dict and data.get('code') == 'NOT_FOUND' and vars(res).get('_content_consumed') is True:
-            dictionary = {"status_code": vars(res).get('status_code'), "code": data.get('code'), "details": data.get('details'), "requestId": data.get('requestId')}
-            exception = get_exception_for_content(data)
-            raise exception(dictionary)
+        else:
 
-        if type(data) is dict and data.get('code') == 'SERVER_IS_BUSY' and vars(res).get('_content_consumed') is True:
-            dictionary = {"status_code": vars(res).get('status_code'), "code": data.get('code'), "details": data.get('details'), "requestId": data.get('requestId')}
-            exception = get_exception_for_content(data)
-            raise exception(dictionary)
+            exception = get_exception_for_code(res.status_code)
 
-        if type(data) is dict and data.get('message') == 'Unauthorized' and vars(res).get('_content_consumed') is True:
-            dictionary = {"status_code": vars(res).get('status_code'), "message": "Unauthorized"}
-            exception = get_exception_for_content(dictionary)
-            raise exception(dictionary)
+            try:
+                js = res.json()
+            except JSONDecodeError:
+                js = res.content
 
-        if type(data) is dict and data.get('details') == 'Invalid authorization inputs' and vars(res).get('_content_consumed') is True:
-            dictionary = {"status_code": vars(res).get('status_code'), "message": "Invalid authorization inputs"}
-            exception = get_exception_for_content(dictionary)
-            raise exception(dictionary)
 
-        if type(data) is dict and data.get('message') == 'Missing Authentication Token' and vars(res).get('_content_consumed') is True:
-            dictionary = {"status_code": vars(res).get('status_code'), "message": "Missing Authentication Token"}
-            exception = get_exception_for_content(dictionary)
-            raise exception(dictionary)
+            raise exception(status_code, js, headers)
+            exit(res.status_code)
 
-        if type(data) is dict and data.get('details') == 'Cannot consume content type' and vars(res).get('_content_consumed') is True:
-            dictionary = {"status_code": vars(res).get('status_code'), "message": data.get('details')}
-            exception = get_exception_for_content(dictionary)
-            raise exception(dictionary)
 
-        headers = vars(res).get('headers')
-        status_code = vars(res).get('status_code')
-        next_token = vars(res).get('_next')
-        return ApiResponse(data, next_token, headers=headers)

python-amazon-ad-api-0.4.5/ad_api/base/credential_provider.py

@@ -0,0 +1,160 @@
+import abc
+import functools
+import json
+import os
+import pprint
+
+from typing import Dict, Iterable, Optional, Type
+
+import confuse
+import logging
+
+logger = logging.getLogger(__name__)
+required_credentials = [
+    'refresh_token',
+    'client_id',
+    'client_secret',
+    'profile_id'
+]
+
+
+class MissingCredentials(Exception):
+    """
+    Credentials are missing, see the error output to find possible causes
+    """
+    pass
+
+
+class BaseCredentialProvider(abc.ABC):
+
+    def __init__(self, credentials: dict or str, *args, **kwargs):
+        self.credentials = credentials
+
+    @abc.abstractmethod
+    def load_credentials(self):
+        pass
+
+
+    def _get_env(self, key):
+        return os.environ.get(f'{key}',
+                              os.environ.get(key))
+
+    def check_credentials(self):
+        try:
+            self.errors = [c for c in required_credentials if
+                           c not in self.credentials.keys() or not self.credentials[c]]
+        except (AttributeError, TypeError):
+            raise MissingCredentials(f'Credentials are missing: {", ".join(required_credentials)}')
+        if not len(self.errors):
+            return self.credentials
+        raise MissingCredentials(f'Credentials are missing: {", ".join(self.errors)}')
+
+
+
+class FromEnvCredentialProvider(BaseCredentialProvider):
+
+    def __init__(self, *args, **kwargs):
+        pass
+
+    def load_credentials(self):
+        account_data = dict(
+            refresh_token=self._get_env('AD_API_REFRESH_TOKEN'),
+            client_id=self._get_env('AD_API_CLIENT_ID'),
+            client_secret=self._get_env('AD_API_CLIENT_SECRET'),
+            profile_id=self._get_env('AD_API_PROFILE_ID'),
+        )
+        self.credentials = account_data
+        self.check_credentials()
+        return self.credentials
+
+    def _get_env(self, key):
+        return os.environ.get(f'{key}',
+                              os.environ.get(key))
+
+class FromCodeCredentialProvider(BaseCredentialProvider):
+
+    def __init__(self, credentials: dict, *args, **kwargs):
+        super().__init__(credentials)
+
+    def load_credentials(self):
+        self.check_credentials()
+        return self.credentials
+
+
+class FromConfigFileCredentialProvider(BaseCredentialProvider):
+
+    file = 'credentials.yml' # Will moved to default confuse config.yaml
+
+    def __init__(self, account: str, *args, **kwargs):
+        self.account = account
+
+    def load_credentials(self):
+        try:
+            config = confuse.Configuration('python-ad-api')
+            config_filename = os.path.join(config.config_dir(), self.file)
+            config.set_file(config_filename)
+            account_data = config[self.account].get()
+            super().__init__(account_data)
+            self.check_credentials()
+            return (account_data)
+
+
+        except confuse.exceptions.NotFoundError:
+            raise MissingCredentials(f'The account {self.account} was not setup in your configuration file.')
+        except confuse.exceptions.ConfigReadError:
+            raise MissingCredentials(
+                f'Neither environment variables nor a config file were found. '
+                f'Please set the correct variables, or use a config file (credentials.yml). '
+                f'See https://confuse.readthedocs.io/en/latest/usage.html#search-paths for search paths.'
+            )
+
+
+class CredentialProvider():
+
+    def load_credentials(self):
+        pass
+
+    def _get_env(self, key):
+        return os.environ.get(f'{key}',
+                              os.environ.get(key))
+
+    def __init__(
+        self,
+        account: str = 'default',
+        credentials: Optional[Dict[str, str]] = None,
+    ):
+
+        client_id_env = self._get_env('AD_API_CLIENT_ID'),
+        client_secret_env = self._get_env('AD_API_CLIENT_SECRET')
+
+        if client_id_env is not None and client_secret_env is not None:
+
+            try:
+                self.credentials = FromEnvCredentialProvider().load_credentials()
+            except MissingCredentials:
+                logging.error("MissingCredentials")
+                logging.error(MissingCredentials)
+
+        elif isinstance(credentials, dict):
+            try:
+                self.credentials = FromCodeCredentialProvider(credentials).load_credentials()
+
+            except MissingCredentials:
+                logging.error("MissingCredentials")
+                logging.error(MissingCredentials)
+
+        else:
+
+            try:
+                self.credentials = FromConfigFileCredentialProvider(account).load_credentials()
+
+            except MissingCredentials:
+                logging.error("MissingCredentials")
+                logging.error(MissingCredentials)
+
+    class Config:
+        def __init__(self, **kwargs):
+            self.refresh_token = kwargs.get('refresh_token')
+            self.client_id = kwargs.get('client_id')
+            self.client_secret = kwargs.get('client_secret')
+            self.profile_id = kwargs.get('profile_id')