تتيح Google Ads API ربط فيديوهات YouTube بحسابك على "إعلانات Google". يشرح هذا الدليل كيفية استخدام واجهة برمجة التطبيقات لإضافة روابط إلى حسابك وإزالتها.
ربط الفيديوهات
يمكن ربط الفيديوهات بحسابك بطريقتَين، وذلك استنادًا إلى الجهة التي تبدأ العملية:
- طلب ربط فيديو بحسابك في هذا السيناريو، عليك إرسال طلب إلى صانع محتوى، ويجب أن يقبل هذا الطلب لإنشاء رابط يؤدي إلى الفيديو الخاص به. يمكنك إلغاء طلب تم تمديده قبل قبوله، وكذلك إزالة فيديو مرتبط بعد قبوله.
- يطلب صانع الفيديو ربط الفيديو بحسابك على "إعلانات Google". ويمكنك بعد ذلك اختيار قبول طلبه أو رفضه.
يتم استخدام الطرق التالية في كل سيناريو:
| السيناريو | الإجراء | الملاحظات |
|---|---|---|
| السيناريو 1 | الحصول على معلومات الفيديو من YouTube API | استخدِم YouTube API
للحصول على channel_id لإرسال طلب رابط الفيديو إليه، أو video_id
للفيديو الذي تريد الربط به. يمكن أيضًا سحب video_id
من عنوان URL الخاص بالفيديو عن طريق سحب الأحرف الأحد عشر بعد "v=". |
| إنشاء طلب ربط حساب | استخدِم
DataLinkService.CreateDataLink method
لإنشاء طلب ربط حساب. يجب عدم ضبط 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 لرفضه. |
يمكن أن تحدث الأخطاء الشائعة التالية في سير العمل هذا:
| رمز الخطأ | الشرح |
|---|---|
DataLinkError.PERMISSION_DENIED |
لا يملك العميل الإذن بتنفيذ هذا الإجراء. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
تعذّر إنشاء رابط لفيديو لأنّ رقم تعريفه غير صالح. |