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