การฝึกปฏิบัติ: แอปพลิเคชัน Bing Ads API บนเดสก์ท็อปใน Java

คู่มือนี้อธิบายวิธีที่คุณสามารถดาวน์โหลดตัวอย่าง Java สําหรับ Bing Ads API จาก แหล่งที่มา GitHub แก้ไขด้วยข้อมูลประจําตัวของคุณ และเรียกใช้ในคอนโซลภายในเครื่อง

ตามค่าเริ่มต้น ตัวอย่างพร้อมที่จะเรียกใช้ในสภาพแวดล้อม Sandbox หากคุณกําลังกําหนดเป้าหมายสภาพแวดล้อมการผลิต คุณจะต้องใช้ โทเค็นนักพัฒนาผลิตของคุณด้วย นอกจากนี้คุณจะต้องลงทะเบียนแอปพลิเคชันและจดบันทึก ID แอปพลิเคชันที่จะใช้เป็น ClientId ในการฝึกปฏิบัติด้านล่าง สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับการลงทะเบียนแอปพลิเคชันและโฟลว์การให้สิทธิ์รหัสการให้สิทธิ์ โปรดดูการรับรองความถูกต้องด้วย OAuth

การฝึกปฏิบัติโค้ด

1. ติดตั้ง Visual Studio Code และ Debugger สําหรับ Java คุณสามารถปรับเปลี่ยนขั้นตอนเหล่านี้ถ้าคุณคุ้นเคยกับตัวแก้ไขหรือสภาพแวดล้อมการพัฒนาอื่นอยู่แล้ว

2. ดาวน์โหลดและติดตั้ง Git

3. นําทางไปยังไดเรกทอรีภายในที่ว่างเปล่า เช่น c:\dev\BingAdsJava และโคลน Bing Ads Java SDK เช่น พิมพ์git clone https://github.com/BingAds/BingAds-Java-SDK.git ตอนนี้คุณควรเห็นไดเรกทอรี SDK ซึ่งมีทั้งแหล่งข้อมูล SDK และตัวอย่าง

4. เปิด Visual Studio Code และเปิดไดเรกทอรี BingAdsDesktopApp (ไฟล์... เปิดโฟลเดอร์...) เช่น C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp

5. ตามค่าเริ่มต้น ตัวอย่างพร้อมที่จะเรียกใช้ในสภาพแวดล้อม Sandbox เพื่อใช้การผลิต ภายใน C:\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp\src\main\java\com\microsoft\bingads\examples\ExampleBase.java ตั้งค่า API_ENVIRONMENT และ ApiEnvironment.PRODUCTION แก้ไข ClientId ด้วย ID แอปพลิเคชันที่ถูกเตรียมใช้งานเมื่อคุณลงทะเบียนแอปพลิเคชันของคุณ นอกจากนี้คุณจะต้องแก้ไขค่า DeveloperToken ด้วย โทเค็นนักพัฒนาผลิตของคุณ

6. เพิ่มการขึ้นต่อกันของ Maven สําหรับ Microsoft.bingads ลงในโครงการของคุณก่อนที่จะเรียกใช้ API

7. คลิกขวาที่ SearchUserAccounts.java แล้วคลิก เรียกใช้

8. คุณควรได้รับพร้อมท์ให้คัดลอกและวาง URL การอนุญาตลงในเว็บเบราว์เซอร์ ผู้ใช้จําเป็นต้องได้รับความยินยอมเพียงครั้งเดียว และหลังจากนั้นคุณจะสามารถใช้โทเค็นรีเฟรชเพื่อร้องขอโทเค็นการเข้าถึงและการรีเฟรชใหม่ได้

9. หลังจากอนุญาตแอปพลิเคชันของคุณเพื่อจัดการบัญชี Microsoft Advertising ของคุณแล้ว ให้คัดลอก URL ที่เป็นผลลัพธ์ (พร้อมพารามิเตอร์ โค้ด ) และวางลงในหน้าต่างคอนโซล จากนั้นกดปุ่ม Enter (return) เพื่อดําเนินการต่อไป

10. โทเค็นรีเฟรชจะถูกเขียนไปยัง refresh.txt การเรียกที่ตามมาไปยังฟังก์ชัน ตัวช่วยเหลือ authenticateWithOAuth จะพยายามอ่านโทเค็นรีเฟรชจากตําแหน่งที่ตั้งเดียวกัน คุณสามารถเปลี่ยนตําแหน่งที่ตั้งโดยการแก้ไขการตั้งค่า RefreshTokenPath ภายใน ExampleBase.java

    สิ่งสำคัญ

    ตัวอย่างการเริ่มต้นด่วนนี้ไม่แนะนําเหมือนในการผลิต คุณควรจัดเก็บโทเค็นรีเฟรชในตําแหน่งที่ปลอดภัยเท่านั้น

ดูเพิ่มเติม

กระบะทราย
ตัวอย่างรหัส API ของโฆษณา Bing
ที่อยู่ของบริการเว็บ API ของ Bing Ads