教程介紹
本節(jié)將介紹微軟廣告的應用注冊和驗證，微軟廣告應用的注冊在微軟云完成，通過獲取令牌、調用API來驗證應用是否正確注冊和配置
整個過程會涉及三類賬號/角色
- 應用注冊。服務商或廣告主在微軟云（Azure）注冊微軟App
- 令牌獲取。對于希望訪問的賬號，使用其進行OAuth授權
- 調用API。開發(fā)者使用訪問令牌和開發(fā)者令牌調用API
注意，上述步驟都要求有微軟賬號，但取決于具體的使用場景，這些賬號可以不同也可以相同，并沒有強制要求。
對于工具型或平臺型App，這三者往往不同。這里類比一下微信的點單小程序，第一個賬號表示的是App所有者的賬號（類比為店家），第二個賬號表示的是實際用來打廣告的賬號（類比為點單的客戶），第三個表示的是使用這個App的開發(fā)者（類比為店家聘請的小程序開發(fā)者）
但大多數(shù)App實際不會提供給第三方使用，例如內部工具開發(fā)或CRM集成，所以為了簡單起見，三個賬號可能相同或部分相同
應用注冊
在微軟云（Azure）注冊微軟App
微軟云應用注冊頁面
-
點擊以下鏈接，側邊欄選擇【應用注冊】，然后在右側應用列表中點擊【注冊應用程序】按鈕
鏈接：https://aka.ms/bingads-app （或者在微軟云搜索【應用注冊】服務）
語言切換：可依次點擊【右上角齒輪（Settings）】、左側【Langauge + Region】、【Language】、【中文(簡體)】、【Apply】進行語言切換
[圖片上傳失敗...(image-1d67e5-1719213930609)]
應用信息填寫
- 名稱。填寫應用名稱
- 受支持的帳戶類型。請注意受支持的帳戶類型一定要選擇【任何組織目錄(任何 Microsoft Entra ID 租戶 - 多租戶)中的帳戶和個人 Microsoft 帳戶(例如 Skype、Xbox) 】！！否則會獲取不到令牌??！
[圖片上傳失敗...(image-53db47-1719213930609)] - 點擊【注冊】
應用配置
接下來需要配置應用的重定向URI，這是因為在客戶OAuth授權跳轉時，微軟權限認證平臺會驗證重定向URI，并只會對已配置的重定向URI授予激活碼（RedeemCode）
在應用列表中點擊剛剛創(chuàng)建的應用，然后在應用概覽頁點擊【添加重定向URI】
[圖片上傳失敗...(image-a06eab-1719213930609)]
然后依次點擊
【添加平臺】
【移動和桌面應用程序】
【https://login.microsoftonline.com/common/oauth2/nativeclient】
【配置】
這里需要注意的是：在平臺類型的選擇中，絕大多數(shù)微軟廣告App選擇移動和桌面應用程序就已經足夠了。比較容易混淆的Web應用類型是給平臺或工具型App使用的，這類App的特點是App方在實際上不擁有所操作的廣告賬戶，但絕大多數(shù)微軟廣告App其實是給自家公司用的，不會服務于第三方客戶。
Web應用：例如你需要在微信上開發(fā)一個給別人使用的點單小程序，那么這個點單小程序服務的客戶是未知的，你不直接擁有他，需要客戶在初次使用時授權、或令牌過期時重新授權
移動和桌面應用程序：例如你開發(fā)了一個網(wǎng)盤小程序，管理你自己的文件、相片、視頻，這些被操作的對象實際上就是屬于你的
完成后效果如下圖，注意回到應用詳情頁復制【應用程序（客戶端）ID】在后續(xù)步驟中使用
[圖片上傳失敗...(image-dba000-1719213930609)]
令牌獲取
令牌介紹
微軟廣告API的權限認證基于微軟的權限認證平臺，使用Refresh Token和Access Token進行交互。除此之外，還需要Developer Token來訪問微軟廣告API，其中
- Refresh Token（簡稱RT）是有效期較長的令牌，用于刷新Access Token，有效期通常為幾個月
- Access Token（簡稱AT）是每次調用API必須要傳的參數(shù)，表示當前這次調用的權限和所能訪問的資源。注意，AT是用戶級別的，也就是說，在后續(xù)步驟中通過OAuth授權拿到AT后，只要AT不過期，就可以通過API訪問該用戶有權訪問的所有廣告賬戶，不需要再次交互授權
- Developer Token用于標識是哪位開發(fā)者在使用這個App進行API調用
獲取Refresh Token和Access Token
出錯自檢：如果碰到問題，請仔細檢查App ID是否正確，App是否配置正確，尤其是【平臺類型】和【受支持的帳戶類型】
- 在
token腳本中設置clientId，即App ID（微軟云應用詳情頁的【應用程序（客戶端）ID】）并繼續(xù)，此時需要打開瀏覽器進行交互授權
Windows:
powershell .\token.ps1
Linux（需要安裝支持open和jq）:
source ./token.sh
- 使用希望訪問的賬戶登錄，并確認授權，如果操作無誤，瀏覽器的地址會變成
https://login.microsoftonline.com/common/oauth2/nativeclient?code=...&state=ClientStateGoesHere的格式，將這個地址復制進腳本中繼續(xù) - 腳本會自動解析URL中的
code參數(shù)進行激活并拿到RT和AT，注意保存下來供后續(xù)使用
出錯自檢：AT是JWT token，即ey開頭的字符串。腳本輸出格式為：
Access token: ey...
Access token expires in: ...
Refresh token: ...
Access token: ey...
Refresh token: ...
獲取開發(fā)者令牌
廣告賬號的超級管理員登錄微軟廣告開發(fā)者平臺https://developers.ads.microsoft.com/Account，點擊【Request Token】，然后刷新頁面即可看到開發(fā)者令牌(Developer token)，令牌格式是16位數(shù)字字母混合的字符串，例如：111AAAAAAA111111
調用API
在get-user腳本中輸入accessToken和developerToken并執(zhí)行，成功后控制臺會輸出當前AT對應的用戶信息，例如
Windows:
powershell .\get-user.ps1
Linux:
source ./get-user.sh
結果：
<s:Envelope...>
...
<a:FirstName>...</a:FirstName><a:LastName>...</a:LastName>
...
</s:Envelope>
若上述內容正確完成，則表示應用已成功注冊及配置
參考資料
微軟廣告API官方文檔： https://learn.microsoft.com/zh-cn/advertising/guides/get-started?view=bingads-13
