معرفی شرکت ها
TikTok-Business-API-1.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Minimal api wrapper for the TikTok Business API
| ویژگی | مقدار |
|---|---|
| سیستم عامل | OS Independent |
| نام فایل | TikTok-Business-API-1.1 |
| نام | TikTok-Business-API |
| نسخه کتابخانه | 1.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Sharashchandra Desai |
| ایمیل نویسنده | Sharashchandra Desai <sharashchandra.desai@gmail.com> |
| آدرس صفحه اصلی | https://github.com/Sharashchandra/TikTok-Business-API |
| آدرس اینترنتی | https://pypi.org/project/TikTok-Business-API/ |
| مجوز | MIT License Copyright (c) 2022 Sharashchandra Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission 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. |
# TikTok Business API Wrapper
This is a minimal api wrapper to interface with the Tiktok business API
# Installation
``` console
pip install TikTok-Business-API
```
The current version of this package only covers the Tiktok Business API. Tiktok Developer API support will be added in a later version.
# Getting Started
To get started, get an Access Token from the app detail page in the [TikTok for Business Developers page](https://ads.tiktok.com/marketing_api/apps/).
You can also use the access token from the sandbox account to make test calls to the sandbox account.
# Authorization
Obtaining an access_token is simple. Visit the authorization url mentioned in the app detail page. Once you login and grant authorization, it will redirect you to the callback url mentioned while creating the app. The auth_code can be gotten from url after the callback.
By default, the access token will be written to `~/.tiktok/access_token.json`
``` python
from tiktok.business.oauth2 import OAuth
access_token = OAuth2.get_access_token(
app_id='YOUR_APP_ID',
secret='YOUR_APP_SECRET',
auth_code='AUTH_CODE FROM CALLBACK',
write_to_file=True,
file_path="access_token.json"
)
```
# Initializing a client
This api wrapper makes it easy to switch between the main app and the sandbox account. This client will automatically include the advertiser id to every request if not specified otherwise.The Access Token is included in the header for all the api calls made.
You can initialize a new `Client` by making use of the `access_token.json` file generated in the previous step. The access tokens will be loaded in from `~/.tiktok/access_token.json` if path is not mentioned. Advertiser Id can also added to the `access_token.json`.
``` python
from tiktok.business.client import TikTokBusinessClient
client = TikTokBusinessClient.from_json_file(
json_file_path="/path/to/file",
sandbox=True
)
```
You can initialize a new `Client` with just the Access Token and Advertiser Id to get started.
``` python
from tiktok.business.client import TikTokBusinessClient
client = TikTokBusinessClient(
access_token='YOUR_ACCESS_TOKEN',
advertiser_id='AD_ADVERTISER_ID'
)
```
You can also create a new `Client` for the sandbox account in the same way
``` python
from tiktok.business.client import TikTokBusinessClient
client = TikTokBusinessClient(
access_token='SANDBOX_ACCESS_TOKEN',
advertiser_id='SANDBOX_ADVERTISER_ID',
sandbox=True
)
```
The actual function calls remain the same with the only difference being in the url. URLs:
* SANDBOX_URL = https://sandbox-ads.tiktok.com/open_api
* BUSINESS_URL = https://business-api.tiktok.com/open_api
# Endpoints
All the functionality of the modules can be accessed as attributes of the client object. The functions for each module differs and follows the [TikTok Business API Documentation](https://ads.tiktok.com/marketing_api/docs)
Follow the steps outlined here to [create a client object](#Initializing-a-client)
All of the function take the same parameters `params` as mentioned in the official documentation unless specified.
The client object keeps a track of the advertiser id and passes it along with each request. There is no need to explicitly pass it in the params.
## Campaign
``` python
# Get campaigns (page_size set to 1000 by default)
client.campaign.get_campaigns(params)
# Create campaign
client.campaign.create_campaigns(params)
# Update campaign
client.campaign.update_campaign(params)
# Enable campaigns (max allowed 100 campaign ids in a single request)
client.campaign.enable_campaigns(campaigns_ids: List[str])
# Disable campaigns (max allowed 100 campaign ids in a single request)
client.campaign.disable_campaigns(campaigns_ids: List[str])
# Delete campaigns (max allowed 100 campaign ids in a single request)
client.campaign.delete_campaigns(campaigns_ids: List[str])
```
## Ad Group
``` python
# Get ad groups (page_size set to 1000 by default)
client.ad_group.get_ad_groups(params)
# Create ad group
client.ad_group.create_ad_group(params)
# Update ad group
client.ad_group.update_ad_group(params)
# Update ad group budget
client.ad_group.update_ad_group_budget(params)
# Enable ad groups (max allowed 100 adgroup_ids in a single request)
client.ad_group.enable_adgroups(adgroups_ids: List[str])
# Disable adgroups (max allowed 100 adgroup_ids in a single request)
client.ad_group.disable_adgroups(adgroups_ids: List[str])
# Delete adgroups (max allowed 100 adgroup_ids in a single request)
client.ad_group.delete_adgroups(adgroups_ids: List[str])
```
## Ad
``` python
# Get ads (page_size set to 1000 by default)
client.ad.get_ads(params)
# Create ad
client.ad.create_ad(params)
# Update ad
client.ad.update_ad(params)
# Enable ads (max allowed 100 ad_ids in a single request)
client.ad.enable_ads(ads_ids: List[str])
# Disable ads (max allowed 100 ad_ids in a single request)
client.ad.disable_ads(ads_ids: List[str])
# Delete ads (max allowed 100 ad_ids in a single request)
client.ad.delete_ads(ads_ids: List[str])
```
## Creative
### Image
``` python
# Upload image file
client.creative.image.upload_file(file_path: str, file_name: Optional[str])
# Upload file by url
client.creative.image.upload_file_by_url(url: str, file_name: Optional[str])
# Upload file by file id
client.creative.image.upload_file_by_file_id(file_id: str, file_name: Optional[str])
```
### Video
``` python
# Upload video file
client.creative.video.upload_file(file_path: str, file_name: Optional[str])
# Upload file by url
client.creative.video.upload_file_by_url(url: str, file_name: Optional[str])
# Upload file by file id
client.creative.video.upload_file_by_file_id(file_id: str, file_name: Optional[str])
```
### Music
``` python
# Upload music file
client.creative.music.upload_file(file_path: str, file_name: Optional[str])
# Upload file by url
client.creative.music.upload_file_by_url(url: str, file_name: Optional[str])
# Upload file by file id
client.creative.music.upload_file_by_file_id(file_id: str, file_name: Optional[str])
```
## Audience
``` python
# Get all audiences (page_size set to 1000 by default)
client.audience.get_all_audiences(params)
# Get audience details (max allowed 100 custom_audience_ids in a single request)
client.audience.get_audience_details(custom_audience_ids: List[str])
# Upload audience (each file needs to be less 50 mb. will add functionality to handle bigger file sizes in future release)
client.audience.upload_audience(file_path: str, calculate_type: str)
# Create custom audience by tiktok file paths
client.audience.create_audience_by_file(params)
# Create custom audience by rules
client.audience.create_audience_by_rule(params)
# Create lookalike audience by file_ids
client.audience.create_lookalike_audience(params)
# Update custom audience
client.audience.update_audience(params)
# Delete custom audience (max allowed 100 custom_audience_ids in a single request)
client.audience.delete_audience(custom_audience_ids: List[str])
# Share custom audience with advertiser accounts
client.audience.share_audience(params)
# Cancel audience sharing (currently an allowlist-only feature)
client.audience.cancel_audience_sharing(params)
# Get audience share log (currently an allowlist-only feature)
client.audience.get_audience_sharing_log(custom_audience_id: str)
```
## Reports
``` python
# Get synchronous report (page_size set to 1000 by default)
client.reports.get_synchronous_report(params)
# Create asynchronous report task (page_size set to 1000 by default) (currently an allowlist-only feature)
client.reports.create_asynchronous_report_task(params)
# Check asynchronous report task
client.reports.check_asynchronous_report_task(task_id: str)
# Download asynchronous report
client.reports.download_asynchronous_report(task_id: str, file_path: str)
```
نیازمندی
| مقدار | نام |
|---|---|
| - | requests |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >3.8 | Python |
نحوه نصب
نصب پکیج whl TikTok-Business-API-1.1:
pip install TikTok-Business-API-1.1.whl
نصب پکیج tar.gz TikTok-Business-API-1.1:
pip install TikTok-Business-API-1.1.tar.gz