تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتوافق تطبيق YouTube Reporting API وتطبيق YouTube Analytics API مع بروتوكول OAuth 2.0 لمنح الإذن بالوصول إلى بيانات المستخدمين الخاصة.
توضّح القائمة التالية بعض المفاهيم الأساسية في OAuth 2.0:
عندما يحاول المستخدم لأول مرة استخدام ميزات في تطبيقك تتطلّب تسجيل الدخول إلى Google Account or YouTube account، يبدأ تطبيقك عملية التفويض OAuth 2.0.
يوجّه تطبيقك المستخدم إلى خادم التفويض في Google. يحدّد الرابط المؤدي إلى هذه الصفحة scope الوصول الذي يطلبه تطبيقك لحساب المستخدم. تحدّد scope الموارد التي يمكن لتطبيقك استردادها أو إدراجها أو تعديلها أو حذفها عند عمله كمستخدم تمت مصادقته.
إذا وافق المستخدِم على منح تطبيقك الإذن بالوصول إلى هذه الموارد، سيرسل Google رمزًا إلى تطبيقك. اعتمادًا على نوع تطبيقك، إما أن يتحقّق من صحة الرمز المميّز أو يستبدله بنوع مختلف من الرموز المميّزة.
على سبيل المثال، يبدّل تطبيق ويب من جهة الخادم الرمز المميز الذي تم إرجاعه برمز دخول ورمز مميز لإعادة التحميل. يسمح رمز الدخول للتطبيق بتفويض الطلبات نيابةً عن المستخدم، ويسمح رمز إعادة التحميل للتطبيق باسترداد رمز دخول جديد عند انتهاء صلاحية رمز الدخول الأصلي.
يتوافق مسار OAuth 2.0 لأجهزة التلفزيون والأجهزة التي تتطلّب إدخال بيانات محدودة مع الأجهزة التي تتطلّب إدخال بيانات محدودة، مثل وحدات تحكّم الألعاب وكاميرات الفيديو.
The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
يتيح مسار OAuth 2.0 لحسابات الخدمة التفاعلات بين الخوادم التي لا تصل إلى معلومات المستخدم.
ومع ذلك، لا تتوافق الأداتان YouTube Reporting API وYouTube Analytics API مع هذا المسار.
Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate an error.
تحديد نطاقات الوصول
تتيح النطاقات لتطبيقك طلب الوصول إلى الموارد التي يحتاجها فقط، كما تتيح للمستخدمين التحكّم في مقدار الوصول الذي يمنحونه لتطبيقك. وبالتالي، قد تكون هناك علاقة عكسية بين عدد النطاقات المطلوبة واحتمالية الحصول على موافقة المستخدم.
قبل البدء في تنفيذ تفويض OAuth 2.0، ننصحك بتحديد النطاقات التي سيحتاج تطبيقك إلى إذن للوصول إليها.
تستخدم واجهة YouTube Analytics API النطاقات التالية:
تاريخ التعديل الأخير: 2025-07-16 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-07-16 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The YouTube Reporting API and YouTube Analytics API utilize OAuth 2.0 for authorizing access to private user data."],["OAuth 2.0 requires user consent, and the scope requested determines the resources the application can access, with a possible inverse relationship between the number of scopes and the likelihood of consent."],["Google's OAuth 2.0 supports various flows including server-side web apps, JavaScript web apps, and mobile/desktop apps, but it doesn't support the device flow for YouTube Reporting and Analytics APIs, or the service account flow."],["Before implementing OAuth 2.0, it's recommended to identify the necessary scopes, with specific scopes for the YouTube Analytics API and YouTube Reporting API being detailed, as well as a document containing a full list of possible scopes for Google APIs."],["If your application uses scopes that permit access to certain user data, you might need to complete a verification process, especially if you encounter an \"unverified app\" warning."]]],["OAuth 2.0 authorizes access to private YouTube user data. Applications initiate authorization, directing users to Google's server to specify access scopes. User consent grants a token, which can be exchanged for access and refresh tokens. Credentials must be obtained via the Google API Console. Supported flows include server-side, JavaScript, and mobile/desktop apps, but not limited-input devices or service accounts. Scopes, defined for YouTube Analytics and Reporting APIs, dictate resource access and influence user consent. Public apps accessing user data must undergo verification.\n"]]
