使用這些基本 REST API 最佳實踐構建出色的 API
Step 3：完善開發者資料。將資料填寫完整并通過手機驗證碼驗證通過后，即完成開發者注冊。
Step1: 注冊成為開發者后，在開發者官網進行登陸并進入應用程序管理看板，可選擇創建私有應用或第三方應用（私有應用的前置條件是您的開發者注冊QQ賬號同時為代理商、廣告主、商務管家等身份的開戶QQ），則界面會顯示相應的創建入口如下圖：
Step 2：點擊“創建新應用”進入創建應用程序界面，填寫應用名稱、應用介紹信息等。請注意，私有應用需要填寫的內容比第三方應用少，但僅可管理該QQ號對應的廣告賬號。
2.單擊+新建應用程序以創建新應用程序。
Step 3：您可根據使用需要選擇對應的權限組分類，權限組分類的詳細介紹可通過權限等級進一步了解 – 創建后，私有應用自動審核通過，您可以立即開始相關能力的搭建。第三方應用則會在2-3個工作日內進行審核。
Token是在Marketing API操作指定賬號的身份憑證，當您需要操作特定廣告賬號時，您需要使用該廣告賬號對您的開發者應用進行授權，以獲取access_token和refresh_token，所有接口均通過請求參數中傳遞的 access_token（授權令牌）來進行身份認證和鑒權，系統會在校驗 access_token有效、接口調用配額未用完、接口調用頻次未超限3個條件符合后接受此次請求進行具體業務處理并做出響應。
Marketing API目前支持代理商/商務管家/廣告主等賬號類型進行授權鑒權。
本節將為您介紹如何進行 Marketing API 的授權認證 。
該環節您可以獲取指定賬號的access_token和refresh_token，其中：
進入應用詳情界面
1. 首先選擇您要操作的賬戶身份：如廣告主、服務商、商務管家、T1等（因同一個QQ可以同時具有多個身份，不同的身份的token是不同的）。
2. 點擊“獲取或重置”即可獲取或者重置您的token
客戶需要通過您的應用進行推廣操作時，您的應用需要先引導客戶完成至少一次 OAuth 2.0 認證操作，以便獲得調用接口操作的客戶的推廣帳號所必須的 access_token 。Marketing API的 OAuth 2.0 遵循業界通用的規范和流程，完成 OAuth 2.0 認證（當前只支持 server-side 模式）需要完成以下步驟：
詳細描述如下：
Step 1：引導客戶完成OAuth 2.0認證獲得authorization_code，獲得 authorization_code 需要引導客戶完成 OAuth 2.0 的認證。調用 OAuth 2.0 授權頁面的URL形如：https://developers.e.qq.com/oauth/authorize?client_id=123456&redirect_uri=https%3a%2f%2fwww.example.com%3fpara1%3da%26para2%3db&state=&scope=ads_management&account_type=ACCOUNT_TYPE_QQ 。其中：
| 賬戶分類 | 支持角色 | 可管理的賬戶范圍 |
|---|---|---|
| 商務管家賬號 | 超級管理員（開戶qq/微信） | 該商務管家及其認領的所有賬戶 |
| 代理商主體賬號 | 代理商超級管理員（開戶qq/微信） | 當前代理商主體下所有代理商和所有代理子客戶 |
| 代理商帳號 | 代理商超級管理員（開戶qq/微信） | 當前代理商及所有代理子客戶 |
| 代理商帳號 | 代理商管理員/子賬號管理員/運營人員 | 該員工有權管理的所有代理商子客 |
| 代理商帳號 | 廣告主員工（自理投放管理員） | 該員工有權管理的所有代理商子客 |
| 直客廣告主賬號 | 超級管理員（開戶qq/微信） | 該廣告主賬戶 |
Step 2：使用 authorization_code 獲得 access_token 和 refresh_token。用 authorization_code 獲得 access_token 和 refresh_token 的接口地址為https://api.e.qq.com/oauth/token ，接口輸入參數如下表所示：
請求參數：
| 字段名 | 類型 | 描述 |
|---|---|---|
| client_id | integer | 應用 id，在開發者官網創建應用后獲得，可通過?應用程序管理頁面?查看 |
| client_secret | string | 應用 secret，在開發者官網創建應用后獲得，可通過?應用程序管理頁面?查看 字段長度最小 1 字節，長度最大 256 字節 |
| grant_type | string | 請求的類型，可選值： authorization_code （授權碼方式獲取 token ）、 refresh_token (刷新 token ) 字段長度最小 1 字節，長度最大 64 字節 |
| authorization_code | string | OAuth 認證 code，可通過獲取 Authorization Code 接口獲取，當 grant_type=authorization_code 時必填 字段長度最小 1 字節，長度最大 64 字節 |
| refresh_token | string | 應用 refresh token，當 grant_type=refresh_token 時必填 字段長度最小 1 字節，長度最大 256 字節 |
| redirect_uri | string | 應用回調地址，當 grant_type=authorization_code 時， redirect_uri 為必傳參數，僅支持 http 和 https，不支持指定端口號，且傳入的地址需要與獲取 authorization_code 時，傳入的回調地址保持一致 字段長度最小 1 字節，長度最大 1024 字節 |
請求示例：
curl -G 'https://api.e.qq.com/oauth/token' \
-d 'client_id=<CLIENT_ID>' \
-d 'client_secret=<CLIENT_SECRET>' \
-d 'grant_type=authorization_code' \
-d 'authorization_code=<AUTHORIZATION_CODE>' \
-d 'redirect_uri=https://www.example.com'返回示例：
{
code: 0,
message: ,
data: {
access_token: 228bd56b7ee039540953352f766b40d31651487e,
refresh_token: 854e744a1f4c6fc20f498e366b9aabd2c4b971fd,
access_token_expires_in: 86400,
refresh_token_expires_in: 2592000
}
}獲得 access_token 后，您可用此調用接口對相關的推廣帳號進行操作，如果發起Marketing API請求可通過發起請求章節進行了解。
值得注意的是，一旦 access_token 失效，您將無法調用接口。access_token 和 refresh_token 的有效期可以通過 oauth/token 接口的返回字段獲取，默認情況下 access_token 和 refresh_token 的有效期如下：
API請求中需要提供必要的通用參數、每個接口要求的參數，并聲明正確的編碼方式。以curl發起請求獲取和創建一個推廣計劃為例。 獲取一個推廣計劃：
curl 'https://api.e.qq.com/v1.1/campaigns/get?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=51959'
-d 'fields=[campaign_id,campaign_name,campaign_type, daily_budget]'
< HTTP/1.1 200 OK
< Content-Type: application/json; charset=utf-8
<
{
code:0,
message:，
data:
{
list:[
{
campaign_id:12345,
campaign_name:推廣計劃1,
campaign_type:CAMPAIGN_TYPE_NORMAL,
daily_budget:1000000
},
{
campaign_id:12346,
campaign_name:推廣計劃2,
campaign_type:CAMPAIGN_TYPE_NORMAL,
daily_budget:10000
},
page_info:{
page:1,
page_size:2,
total_number:2,
total_page:1
}
}
}創建一個推廣計劃：
curl 'https://api.e.qq.com/v1.1/campaigns/add?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
account_id: 51959,
campaign_name: test,
campaign_type: CAMPAIGN_TYPE_NORMAL,
daily_budget: 10000,
promoted_object_type,PROMOTED_OBJECT_TYPE_APP_IOS
}'
* Connected to api.e.qq.com (10.10.10.10) port 443 (#0)
> POST / HTTP/1.1
> User-Agent: curl/7.41.0
> Host: api.e.qq.com
> Content-Type: application/json
> Content-Length: 64
* upload completely sent off: 64 out of 64 bytes
< HTTP/1.1 200 OK
< Content-Type: application/json; charset=utf-8
<
{
code:0,
message:，
data:
{
campaign_id:23456
}
}Q：如何找到騰訊廣告開放平臺
A：冪簡集成是國內領先的API集成管理平臺，專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API：通過關鍵詞搜索API(例如，輸入’騰訊廣告開放平臺‘這類品類詞，更容易找到結果)、或者從API hub分類頁進入尋找。
Q：開發者官網的應用程序與推廣的應用程序有什么關系？
A：開發者官網的應用程序是指基于Marketing API開發的應用，比如管理廣告的投放平臺、廣告數據分析工具、自動化營銷的腳本等等，而推廣的應用程序是指廣告主推廣的目標應用。兩者之前并無任何關聯。
Q：我需要為多個應用上報行為數據，需要分別創建應用程序么？
A：不需要。您只需創建一個應用程序，并申請數據上報的權限即可。一個應用可以獲得多個推廣帳號的授權，從而幫多個推廣帳號上報數據。
Q：應用程序審核通過后，是否就可以操作推廣帳號了？
A：應用程序的審核是指給應用程序分配相應的接口權限，但是應用程序能操作哪些推廣帳號，需要通過OAuth 2.0向指定的推廣帳號發起授權申請，當指定的推廣帳號同意授權后，應用程序即可調用接口對該帳號進行操作。
Q：點擊“同意授權”后報錯5014，提示“當前登錄的帳號無可授權的廣告主身份”？
A：代理商、直客、商務管家賬戶需要使用開戶QQ登錄授權；代理商子客，需要有自理類管理員權限的QQ號登錄授權。
Q：開發者應用權限配置后，為什么接口調用依然報錯無權限？
A：作為開發者，您雖然已經擁有了權限，但是還需要廣告主給您授予相應的操作廣告主的權限，權限變更后，請重新操作授權認證流程，具體參考快速入門
除了騰訊廣告開放平臺，還有其他替代服務商也提供類似api服務，例如：
Sleazy Fork API開放平臺、Android-Hilfe API開放平臺、Art19 API開放平臺
更多競品可以在冪簡集成開放平臺中找到。
Q：騰訊廣告開放平臺這個密鑰還適用于哪些api？
添加騰訊廣告服務商子客、查詢騰訊廣告廣告主信息、獲取廣告主資質
本文提供了一份詳盡且實用的“如何獲取騰訊廣告開放平臺訪問密鑰分步指南”，旨在幫助開發者們輕松掌握獲取訪問密鑰的全過程。從注冊騰訊廣告開放平臺賬號，到完成開發者身份認證，再到最終成功獲取訪問密鑰，每一步操作都配以詳盡的說明和指導，確保開發者能夠順利、準確地完成流程。在獲取密鑰后，本文還強調了進行可用性測試的重要性，以確保騰訊廣告開放平臺的各項功能能夠順利集成到應用中，并發揮最佳效果。這不僅有助于提升應用的性能和用戶體驗，還能確保開發者在數字營銷領域取得更大的成功。本文為開發者們提供了一個全面、詳盡且實用的指南，旨在幫助他們順利獲取騰訊廣告開放平臺的訪問密鑰，并有效利用這一平臺資源，為項目或應用提供強大的數據支持，從而在激烈的市場競爭中脫穎而出。