ربط YouTube

تتيح Google Ads API ربط فيديوهات YouTube بحسابك على "إعلانات Google". يشرح هذا الدليل كيفية استخدام واجهة برمجة التطبيقات لإضافة روابط إلى حسابك وإزالتها.

ربط الفيديوهات

يمكن ربط الفيديوهات بحسابك بإحدى الطريقتَين التاليتَين، وذلك حسب الجهة التي تبدأ العملية:

1. تطلب ربط فيديو بحسابك. في هذا السيناريو، يمكنك إرسال طلب إلى أحد صنّاع المحتوى، وعليه قبول هذا الطلب لإنشاء الرابط المؤدي إلى الفيديو. يمكنك إلغاء طلب تم إرساله قبل قبوله، وكذلك إزالة فيديو مرتبط بعد قبوله.
2. يطلب صانع الفيديو ربط الفيديو بحسابك على "إعلانات Google". يمكنك بعد ذلك اختيار قبول طلبه أو رفضه.

في كل سيناريو، يتم استخدام الطريقتَين التاليتَين:

السيناريو	الإجراء	الملاحظات
السيناريو 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 عند إكمال طلب البيانات من واجهة برمجة التطبيقات بنجاح.
	الاطّلاع على حالة الطلب	استخدِم 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	تعذّر إنشاء رابط فيديو لأنّ رقم تعريف الفيديو غير صالح.