نحن بصدد تعديل واجهات برمجة التطبيقات لإعداد التقارير و"إحصاءات YouTube" لتتطابق مع طريقة YouTube في احتساب مشاهدات Shorts.
مزيد من المعلومات
Method jobs.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسترجع معلومات عن مهمة إعداد تقارير محدّدة تم تحديد موعد لها لقناة أو مالك محتوى.
الطلب
طلب HTTP
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}
التفويض
يجب أن يتم السماح بإرسال جميع طلبات البيانات من 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 لتحديد المهمة التي يتم استرجاعها بشكل فريد. |
مَعلمات طلب البحث
| المعلمات |
onBehalfOfContentOwner |
string
معرّف مالك المحتوى الذي يتم تقديم طلب البيانات من أجله. إذا لم يحدّد الطلب قيمة لهذه المَعلمة، يفترض خادم واجهة برمجة التطبيقات أنّ الطلب مخصّص للقناة الخاصة بالمستخدم. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
الردّ
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مورد Job.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-05-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-05-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This endpoint retrieves details about a specific reporting job identified by its `jobId`."],["Authorization is required for all requests, using either `https://www.googleapis.com/auth/yt-analytics.readonly` or `https://www.googleapis.com/auth/yt-analytics-monetary.readonly` scopes."],["The `jobId` is a required path parameter, identifying the specific job to retrieve."],["The optional `onBehalfOfContentOwner` query parameter specifies the content owner for the request, otherwise defaults to the user's channel."],["A successful request returns a `Job` resource in the response body, and the request body itself must be empty."]]],["The content details retrieving a scheduled reporting job's information via the YouTube Reporting API. A `GET` request is made to `https://youtubereporting.googleapis.com/v1/jobs/{jobId}` using OAuth 2.0 authorization. The request requires a `jobId` path parameter and can include an optional `onBehalfOfContentOwner` query parameter. Authorization requires specific scopes like `yt-analytics.readonly` or `yt-analytics-monetary.readonly`. A successful request returns a `Job` resource, and the request body must remain empty.\n"]]
