Google Ads API รองรับการลิงก์วิดีโอ YouTube กับบัญชี Google Ads คู่มือนี้ อธิบายวิธีใช้ API เพื่อเพิ่มและนำลิงก์ออกจากบัญชี
ลิงก์วิดีโอ
คุณลิงก์วิดีโอกับบัญชีได้ 2 วิธี ขึ้นอยู่กับว่าใครเป็นผู้เริ่มกระบวนการ ดังนี้
- คุณขอให้ลิงก์วิดีโอกับบัญชีของคุณ ในกรณีนี้ คุณ ส่งคำขอไปยังครีเอเตอร์ ซึ่งครีเอเตอร์ต้องยอมรับเพื่อสร้าง ลิงก์ไปยังวิดีโอของตน คุณเพิกถอนคำขอที่ขยายเวลาแล้วได้ ก่อนที่คำขอจะได้รับการยอมรับ และยังนำวิดีโอที่ลิงก์ออกได้หลังจากที่คำขอได้รับการยอมรับแล้ว
- ครีเอเตอร์ของวิดีโอขอให้ลิงก์วิดีโอของตนกับบัญชี Google Ads ของคุณ จากนั้นคุณจะเลือกยอมรับหรือปฏิเสธคำขอได้
โดยใช้วิธีต่อไปนี้ในแต่ละสถานการณ์
| สถานการณ์ | การดำเนินการ | หมายเหตุ |
|---|---|---|
| สถานการณ์ที่ 1 | รับข้อมูลวิดีโอจาก YouTube API | ใช้ YouTube API
เพื่อรับ channel_id สำหรับส่งคำขอลิงก์วิดีโอ หรือ video_id
ของวิดีโอที่ต้องการลิงก์ นอกจากนี้ คุณยังดึงvideo_id
จาก URL ของวิดีโอได้โดยดึงอักขระ 11 ตัวหลัง "v=" |
| สร้างคําขอลิงก์ | ใช้วิธี
DataLinkService.CreateDataLink
เพื่อสร้างคำขอลิงก์ ไม่ควรตั้งค่า status
ของ DataLink
เซิร์ฟเวอร์ Google Ads API จะตั้งค่านี้เป็น REQUESTED เมื่อการเรียก API
เสร็จสมบูรณ์เรียบร้อยแล้ว |
|
| ตรวจสอบสถานะของคำขอ | ใช้ GoogleAdsService.SearchStream หรือ GoogleAdsService.Search เพื่อค้นหาแหล่งข้อมูล data_link
และตรวจสอบ
status |
|
| เพิกถอนคำขอ | ใช้วิธี
DataLinkService.UpdateDataLink
เพื่อเพิกถอนคำขอลิงก์โดยเปลี่ยน status ของ
DataLink จาก REQUESTED เป็น REVOKED |
|
| นำลิงก์ออก | ใช้
DataLinkService.RemoveDataLink เพื่อนำวิดีโอที่ลิงก์ออก |
|
| สถานการณ์ที่ 2 | ดึงข้อมูลคำเชิญ | ใช้ GoogleAdsService.Search
หรือ GoogleAdsService.SearchStream
เพื่อค้นหาทรัพยากร data_link
กรองหา
status = PENDING_APPROVAL เพื่อค้นหาคำขอลิงก์
เพื่อยอมรับหรือปฏิเสธ |
| ยอมรับหรือปฏิเสธคำขอลิงก์ | ใช้วิธี
DataLinkService.UpdateDataLink เพื่ออัปเดตสถานะ
ของ DataLink
เป็น ENABLED เพื่อยอมรับหรือ REJECTED เพื่อปฏิเสธ
คำขอ |
ข้อผิดพลาดที่พบบ่อยต่อไปนี้อาจเกิดขึ้นในเวิร์กโฟลว์นี้
| รหัสข้อผิดพลาด | คำอธิบาย |
|---|---|
DataLinkError.PERMISSION_DENIED |
ลูกค้าไม่มีสิทธิ์ดำเนินการนี้ |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
สร้างลิงก์วิดีโอไม่ได้เนื่องจากรหัสวิดีโอไม่ถูกต้อง |