字节跳动 巨量千川的M-API使用(二)

第二章 关于M-api的auth_code获取以及调用api获取access_token和refresh_token

系列文章的第一章申请到APP之后,注意该APP的权限范围,根据需要进行申请。建议能勾选全部勾选,以便后续的功能使用,应用类型为巨量千川-自研投放系统-广告主
登录抖店后,有千川的子账号权限也可以(未验证,有验证的小伙伴告知下是否可以)。
回调地址填入http://qcapi.top/hw.php,找到授权URL项的“点击跳转”就会跳转到授权网页,注意如果有让勾选权限的“允许开发者访问敏感物料”,建议勾选,然后该抖店下的所有广告户数量会有显示,代表着将可以对该抖店下的所有千川户进行授权使用,如果有新增的千川户,务必重新授权该店铺,点击“同意授权”后,将跳转到回调网址,该网址只显示地址栏的网址内容如下:
字节跳动 巨量千川的M-API使用(二)_第1张图片
我们只需要auth_code,需要注意的是这个只有10分钟的有效期,因此我们先把调用的程序写好。接下去就是用python的源代码部分:
第一步 导入需要的包

# coding=utf-8
import time
import http.client
import _thread
import datetime
import sys,os
import random
import requests
import json

有些包是非必要的,也懒得纠正了,如有导入包错误,自行查阅相关资料,相信你愿意看这系列文章的肯定可以的,如仍解决不了,请留言或私信。
第二步 编写2个方法

def get_access_token(APP_ID,secret,auth_code):
    open_api_url_prefix = "https://ad.oceanengine.com/open_api/"
    uri = "oauth2/access_token/"
    url = open_api_url_prefix + uri
    data = {
        "app_id": APP_ID,
        "secret": secret,
        "grant_type": "auth_code",
        "auth_code": auth_code
    }
    rsp = requests.post(url, json=data)
    rsp_data = rsp.json()
    return rsp_data
def refresh_access_token(APP_ID,secret,refresh_token):
    open_api_url_prefix = "https://ad.oceanengine.com/open_api/"
    uri = "oauth2/refresh_token/"
    refresh_token_url = open_api_url_prefix + uri
    data = {
        "appid": APP_ID,
        "secret": secret,
        "grant_type": "refresh_token",
        "refresh_token": refresh_token,
    }
    rsp = requests.post(refresh_token_url, json=data)
    rsp_data = rsp.json()
    return rsp_data

详细的调用网址可参考官方资料https://open.oceanengine.com/labels/12/docs/1697468230144003
官方资料特别详细,为字节的优秀点赞
最后一步 写python主函数

if(__name__=="__main__"):
    APP_ID=input("请输入APP_ID:")
    secret=input("请输入secret:")
    auth_code=input("请输入你的授权码:")
    rsp_data=get_access_token(APP_ID,secret,auth_code)
    print(rsp_data)
    get_refresh_yn=input("是否马上更新y/n:")
    if get_refresh_yn == "y":
        refresh_token=input("请输入你的refresh_token:")
        rsp_data=refresh_access_token(APP_ID,secret,refresh_token)
        print(rsp_data)
        time.sleep(1000)
    else:
        time.sleep(1000)

输入相关参数之后,会得到返回值,里面的access_token字段和refresh_token字段就是我们需要的,后续要更新的话,直接调用其中的def refresh_access_token(APP_ID,secret,refresh_token)方法,详细可以看考官方的文档https://open.oceanengine.com/labels/12/docs/1697468248190020
这是官方文档说明
“Access-Token是调用接口时,操作指定广告账户的身份凭证,有效期为24小时
Refresh-Token用于生成新access_token和refresh_token并且刷新时效达到续期的目的”
因此我们需要在24小时的时候刷新access_token否则会报错。
所以时刻关注刷新是定时的,可以做一个定时器进行更新,因为我是存储在服务器上,会定时更新,因此没做本地定时器开发。如果有需要定时更新的话,可以联系我。
如果需要exe文件可以直接下载https://download.csdn.net/download/weixin_37540336/88285132
拿到access_token之后,我们再结合广告户的ID,也就是advertiser_id 来获取在投计划的实时数据,之所以要存储到mysql,是因为计划的消耗是实时的动态的,我们需要根据每条计划的情况进行规整数据并通过后端的计划给出合适的建议并执行或不执行。
最近更新会比较快,因为刚离职,在入职新公司前的空档,把这系列文章写完。
接着会是第三章的内容 如何获取到相应的数据并存储到mysql,通过php网页显示

你可能感兴趣的:(字节跳动,巨量千川,M-API,字节跳动,python,广告)