Method jobs.reports.get

يستردّ البيانات الوصفية لتقرير معيّن.

الطلب

طلب HTTP

GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}/reports/{reportId}

التفويض

يجب أن يتم السماح بإرسال جميع طلبات البيانات من YouTube Reporting API. يوضّح دليل التفويض كيفية استخدام بروتوكول OAuth 2.0 لاسترداد الرموز المميّزة للتفويض.

تستخدِم طلبات YouTube Reporting API نطاقات التفويض التالية:

المستويات
https://www.googleapis.com/auth/yt-analytics.readonly عرض تقارير "إحصاءات YouTube" للمحتوى في YouTube يمنح هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدمين، مثل أعداد المشاهدات وأعداد التقييمات.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly عرض تقارير "إحصاءات YouTube" المالية للمحتوى في YouTube يمنح هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدِم ومقاييس الأرباح المقدَّرة وأداء الإعلانات.

المعلمات

مَعلمات المسار

المعلمات
jobId string
المعرّف الذي تستخدمه YouTube لتحديد المهمة المرتبطة بالتقرير الذي يتم استرجاعه بشكل فريد.
reportId string
رقم التعريف الذي تستخدمه YouTube لتحديد التقرير الذي يتم استرداده بشكل فريد.

مَعلمات طلب البحث

المعلمات
onBehalfOfContentOwner string
معرّف مالك المحتوى الذي يتم تقديم طلب البيانات من أجله. إذا لم يحدّد الطلب قيمة لهذه المَعلمة، يفترض خادم واجهة برمجة التطبيقات أنّ الطلب مخصّص للقناة الخاصة بالمستخدم.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

الردّ

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مورد Report.

جرّب الآن