يمكنك استرداد مقاييس الأداء الرئيسية لمنتجاتك المشارِكة في الـ برنامج شركاء YouTube باستخدام Reports API. يوضّح هذا الدليل كيفية طلب بيانات الشركاء الخاصة بمنصة YouTube، مثل المبيعات والعمولات والطلبات والمشاهدات والنقرات، التي يتم إسنادها إلى صنّاع محتوى مختلفين ومحتوى فيديو ومنتجات فردية.
يمكنك استخدام MCQL لاختيار المقاييس والسمات من "العروض" المخصّصة لبرنامج شركاء YouTube، والتي تعمل مثل الجداول في طلبات البحث.
المتطلبات الأساسية
قبل استخدام هذا الدليل، تأكَّد مما يلي:
- يجب أن يكون الحساب المستخدَم لمصادقة طلبات البيانات من واجهة برمجة التطبيقات لديه دور الأداء والإحصاءات الذي يمنح إمكانية الوصول إلى مقاييس الأداء.
- يجب أن يشارك حسابك على Google Merchant Center في الـ برنامج شركاء YouTube.
طلب نقطة النهاية للإصدار الأولي
يُرجى العِلم أنّ نقطة النهاية تختلف لأنّها في إصدار أولي علني. لاسترداد بيانات أداء شركاء YouTube، عليك إرسال طلب POST إلى نقطة النهاية v1alpha.
إليك مثال على الطلب الذي يمكنك إرساله:
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
cURL
curl -X POST \
'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
--header 'Accept: application/json' \
--compressed
الاطّلاع على الأداء حسب صنّاع المحتوى
لمعرفة صنّاع المحتوى على YouTube الذين يحقّقون أكبر قدر من التفاعل والمبيعات،
يمكنك طلب البحث في youtube_creator_performance_view.
يجمع هذا العرض المقاييس حسب صنّاع المحتوى الفرديين على YouTube ويتضمّن عناوين صنّاع المحتوى وأرقام تعريف القنوات.
في ما يلي مثال على عبارة SELECT في MCQL يمكنك استخدامها للحصول على أفضل 3 صنّاع محتوى أداءً حسب المبيعات بين 1 مايو و2 مايو 2025.
SELECT
title,
channel_id,
gross_sales,
net_sales,
commissions,
orders,
clicks,
views
FROM youtube_creator_performance_view
WHERE date >= '2025-05-01' AND date <= '2025-05-02'
ORDER BY gross_sales DESC LIMIT 3
يستردّ هذا الطلب عنوان صنّاع المحتوى ورقم تعريف القناة ومقاييس الأداء الرئيسية لأفضل 3 صنّاع محتوى مرتّبين حسب مقياس إجمالي المبيعات خلال النطاق الزمني المحدّد.
الاطّلاع على الأداء حسب المحتوى
لمعرفة فيديوهات YouTube المحدّدة التي تحقّق أفضل أداء، يمكنك طلب البحث في
youtube_content_performance_view.
يجمع هذا العرض المقاييس حسب فيديوهات YouTube الفردية
ويتضمّن عناوين الفيديوهات وأرقام تعريفها.
لاسترداد أفضل 3 فيديوهات حسب المشاهدات بين 1 مايو و2 مايو 2025،
مرِّر عبارة لغة طلبات البحث في Merchant Center
التالية إلى طريقة accounts.reports.search:
SELECT
title,
video_id,
gross_sales,
net_sales,
commissions,
orders,
clicks,
views,
FROM youtube_content_performance_view
WHERE date >= '2025-05-01' AND date <= '2025-05-02'
ORDER BY views DESC LIMIT 3
يستردّ هذا الطلب عنوان الفيديو ورقم تعريفه والمقاييس الرئيسية لأفضل 3
فيديوهات مرتّبة حسب إجمالي عدد views في النطاق الزمني المحدّد.
اعتبارات مهمة
- التواريخ: عليك دائمًا فلترة طلبات البحث حسب
dateباستخدام عباراتWHEREلتحديد الفترة المشمولة بالتقارير. تكون التواريخ بالتنسيقYYYY-MM-DD. - وقت الاستجابة: يعتمد وقت الاستجابة لطلبات البحث على حجم البيانات المطلوبة. ستستغرق طلبات البحث الكبيرة وقتًا أطول وقد تؤدي إلى انتهاء المهلة.