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 เพื่อสร้างคําขอลิงก์ คุณเลือกที่จะระบุ
youtube_video.channel_id เพื่อระบุช่อง
ที่เชื่อมโยงกับวิดีโออย่างชัดเจน และ youtube_link_metadata.brand_channel_id
เพื่อระบุรหัสของช่อง YouTube ของแบรนด์ที่ลิงก์ไว้เพื่อช่วยให้ครีเอเตอร์เข้าใจแบรนด์ของคุณได้ คุณไม่ควรตั้งค่า
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 เพื่อปฏิเสธคำขอ |
ดึงข้อมูลรายละเอียดลิงก์
คุณสามารถใช้
GoogleAdsService.Search
หรือ
GoogleAdsService.SearchStream
เพื่อค้นหาแหล่งข้อมูล data_link
การค้นหาต่อไปนี้จะดึงข้อมูลรายละเอียดลิงก์วิดีโอ YouTube ซึ่งรวมถึงรหัสช่อง YouTube และรหัสช่อง YouTube ของแบรนด์ที่ลิงก์ไว้
SELECT
data_link.resource_name,
data_link.status,
data_link.youtube_video.video_id,
data_link.youtube_video.channel_id,
data_link.youtube_link_metadata.brand_channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'
ข้อผิดพลาดทั่วไปต่อไปนี้อาจเกิดขึ้นในเวิร์กโฟลว์นี้
| รหัสข้อผิดพลาด | คำอธิบาย |
|---|---|
DataLinkError.PERMISSION_DENIED |
ลูกค้าไม่มีสิทธิ์ดำเนินการนี้ |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
สร้างลิงก์วิดีโอไม่ได้เนื่องจากรหัสวิดีโอไม่ถูกต้อง |