Channels

تتيح واجهة برمجة التطبيقات الآن تصنيف قناتك أو فيديوهاتك على أنّها "مخصّصة للأطفال". بالإضافة إلى ذلك، تتضمّن الآن المرجعَين channel وvideo سمة تحدد حالة "محتوى مخصّص للأطفال" لهذه القناة أو هذا الفيديو. تم أيضًا تعديل بنود الخدمة وسياسات المطوّرين الخاصة بخدمات YouTube API في 10 كانون الثاني (يناير) 2020. لمزيد من المعلومات، يُرجى الاطّلاع على سجلّات المراجعات الخاصة بخدمة YouTube Data API وبنود خدمة YouTube API Services.

يحتوي مورد channel على معلومات عن قناة على YouTube.

الطُرق

تتيح واجهة برمجة التطبيقات الطرق التالية لموارد channels:

list
تعرض مجموعة من صفر أو أكثر من موارد channel التي تتطابق مع معايير الطلب. جرِّب ذلك الآن.
تعديل
تعديل البيانات الوصفية للقناة تجدر الإشارة إلى أنّ هذه الطريقة لا تتيح حاليًا سوى إجراء تعديلات على كائنَي brandingSettings وinvideoPromotion لمصدر channel ومواقعه الفرعية. جرِّب ذلك الآن.

تمثيل الموارد

تعرض بنية JSON التالية تنسيق مورد channels:

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "customUrl": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "country": string
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string
    }
  },
  "statistics": {
    "viewCount": unsigned long,
    "subscriberCount": unsigned long,  // this value is rounded to three significant figures
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean,
    "longUploadsStatus": string,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "trackingAnalyticsAccountId": string,
      "unsubscribedTrailer": string,
      "defaultLanguage": string,
      "country": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    }
  },
  "auditDetails": {
    "overallGoodStanding": boolean,
    "communityGuidelinesGoodStanding": boolean,
    "copyrightStrikesGoodStanding": boolean,
    "contentIdClaimsGoodStanding": boolean
  },
  "contentOwnerDetails": {
    "contentOwner": string,
    "timeLinked": datetime
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

أماكن إقامة

يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:

أماكن إقامة
kind string
لتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#channel.
etag etag
رقم تعريف Etag لهذا المورد.
id string
المعرّف الذي تستخدمه YouTube لتحديد القناة بشكلٍ فريد
snippet object
يحتوي العنصر snippet على تفاصيل أساسية عن القناة، مثل عنوانها ووصفها وصورها المصغّرة.
snippet.title string
عنوان القناة.
snippet.description string
وصف القناة الحد الأقصى لطول قيمة السمة هو 1,000 حرف.
snippet.customUrl string
عنوان URL المخصّص للقناة. يوضّح مركز مساعدة YouTube متطلبات الأهلية للحصول على عنوان URL مخصّص، بالإضافة إلى كيفية إعداد عنوان URL.
snippet.publishedAt datetime
تاريخ ووقت إنشاء القناة يتم تحديد القيمة بتنسيق ISO 8601.
snippet.thumbnails object
خريطة للصور المصغّرة المرتبطة بالقناة بالنسبة إلى كل عنصر في الخريطة، يكون المفتاح هو اسم الصورة المصغّرة، والقيمة هي عنصر يحتوي على معلومات أخرى عن الصورة المصغّرة.

عند عرض الصور المصغّرة في تطبيقك، تأكَّد من أنّ الرمز البرمجي يستخدم عناوين URL للصور تمامًا كما يتم عرضها في ردود واجهة برمجة التطبيقات. على سبيل المثال، يجب ألا يستخدم تطبيقك النطاق http بدلاً من النطاق https في عنوان URL الذي يتم عرضه في ردّ واجهة برمجة التطبيقات.

لا تتوفّر عناوين URL المصغّرة للقناة إلا في النطاق https، وهي الطريقة التي تظهر بها عناوين URL في ردود واجهة برمجة التطبيقات. قد تظهر لك صور تالفة في تطبيقك إذا حاول تحميل صور YouTube من نطاق http. قد تكون الصور المصغّرة فارغة للقنوات المنشأة حديثًا وقد يستغرق ظهورها مدة تصل إلى يوم واحد.
snippet.thumbnails.(key) object
في ما يلي قيم المفاتيح الصالحة:
  • default: الصورة المصغّرة التلقائية يبلغ عرض الصورة المصغّرة التلقائية للفيديو أو المرجع الذي يشير إلى فيديو، مثل عنصر قائمة تشغيل أو نتيجة بحث، 120 بكسل وارتفاعها 90 بكسل. يبلغ العرض التلقائي للصورة المصغّرة للقناة 88 بكسل والارتفاع 88 بكسل.
  • ‫medium: نسخة بدرجة دقة أعلى من الصورة المصغّرة بالنسبة إلى الفيديو (أو المرجع الذي يشير إلى فيديو)، يكون عرض هذه الصورة 320 بكسل وارتفاعها 180 بكسل. بالنسبة إلى القناة، يكون عرض هذه الصورة 240 بكسل وارتفاعها 240 بكسل.
  • ‫high: نسخة عالية الدقة من الصورة المصغّرة بالنسبة إلى الفيديو (أو المرجع الذي يشير إلى فيديو)، يكون عرض هذه الصورة 480 بكسل وارتفاعها 360 بكسل. بالنسبة إلى القناة، يكون عرض هذه الصورة 800 بكسل وارتفاعها 800 بكسل.
snippet.thumbnails.(key).url string
عنوان URL للصورة. للحصول على إرشادات إضافية حول استخدام عناوين URL للصور المصغّرة في تطبيقك، اطّلِع على تعريف سمة snippet.thumbnails.
snippet.thumbnails.(key).width unsigned integer
عرض الصورة.
snippet.thumbnails.(key).height unsigned integer
ارتفاع الصورة.
snippet.defaultLanguage string
هي لغة النص في السمتَين snippet.title وsnippet.description لمصدر channel.
snippet.localized object
يحتوي العنصر snippet.localized على عنوان ووصف مترجَمَين للقناة أو يحتوي على عنوان القناة ووصفه باللغة التلقائية للبيانات الوصفية للقناة.
  • يتم عرض النص المترجَم في مقتطف المورد إذا كان طلب channels.list يستخدم المَعلمة hl لتحديد لغة يجب عرض النص المترجَم بها، وكانت قيمة المَعلمة hl تحدِّد لغة تطبيق YouTube، وكان النص المترجَم متوفّرًا بهذه اللغة.
  • يتم عرض البيانات الوصفية للّغة التلقائية في حال عدم تحديد قيمة للمَعلمة hl أو في حال تحديد قيمة ولكنّ البيانات الوصفية المترجَمة غير متاحة للّغة المحدّدة.
يحتوي الحقل على قيمة للقراءة فقط. استخدِم العنصر localizations لإضافة بيانات وصفية مترجَمة أو تعديلها أو حذفها.
snippet.localized.title string
عنوان القناة المترجَم
snippet.localized.description string
وصف القناة المترجَم
snippet.country string
البلد المرتبط بالقناة لضبط قيمة هذا الحقل، عدِّل قيمة الحقل brandingSettings.channel.country.
contentDetails object
يحتوي العنصر contentDetails على معلومات عن محتوى القناة.
contentDetails.relatedPlaylists object
العنصر relatedPlaylists هو خريطة تحدّد قوائم التشغيل المرتبطة بالقناة، مثل الفيديوهات التي حمّلتها القناة أو الفيديوهات التي أعجبتك. يمكنك استرداد أي من قوائم التشغيل هذه باستخدام الطريقة playlists.list.
contentDetails.relatedPlaylists.likes string
معرّف قائمة التشغيل التي تحتوي على الفيديوهات التي أعجبت المستخدم في القناة استخدِم الطريقتَين playlistItems.insert وplaylistItems.delete لإضافة عناصر إلى هذه القائمة أو إزالتها منها.
contentDetails.relatedPlaylists.favorites string
تم إيقاف هذه السمة نهائيًا.

معرّف قائمة التشغيل التي تتضمّن الفيديوهات المفضّلة للقناة. استخدِم الطريقتَين playlistItems.insert وplaylistItems.delete لإضافة عناصر إلى هذه القائمة أو إزالتها منها.

يُرجى العِلم أنّ YouTube أوقفت نهائيًا ميزة الفيديوهات المفضّلة. على سبيل المثال، تم إيقاف سمة statistics.favoriteCount لمورد video نهائيًا في 28 آب (أغسطس) 2015. ونتيجةً لذلك، قد تحتوي قيمة هذا السمة على معرّف قائمة تشغيل يشير إلى قائمة تشغيل فارغة، وبالتالي لا يمكن استرجاعها لأسباب سابقة.
contentDetails.relatedPlaylists.uploads string
معرّف قائمة التشغيل التي تحتوي على الفيديوهات التي حمّلتها القناة. استخدِم الطريقة videos.insert لتحميل فيديوهات جديدة والطريقة videos.delete لحذف الفيديوهات التي سبق أن حمّلتها.
statistics object
يضمّ كائن statistics إحصاءات القناة.
statistics.viewCount unsigned long
عدد مرّات مشاهدة القناة
statistics.commentCount unsigned long
تم إيقاف هذه السمة نهائيًا.

عدد التعليقات على القناة
statistics.subscriberCount unsigned long
عدد المشتركين في القناة ويتم تقريب هذه القيمة إلى ثلاثة أعداد معنوية. لمزيد من التفاصيل حول كيفية تقريب أعداد المشتركين، يُرجى الاطّلاع على سجلّ المراجعات أو مركز مساعدة YouTube.
statistics.hiddenSubscriberCount boolean
يشير إلى ما إذا كان عدد المشتركين في القناة يظهر للجميع.
statistics.videoCount unsigned long
عدد الفيديوهات العلنية التي تم تحميلها إلى القناة تجدر الإشارة إلى أنّ هذه القيمة تعكس عدد الفيديوهات العلنية للقناة فقط، حتى بالنسبة إلى مالكي القناة. يتطابق هذا السلوك مع الأعداد المعروضة على موقع YouTube الإلكتروني.
topicDetails object
يحتوي العنصر topicDetails على معلومات عن المواضيع المرتبطة بالقناة.

ملاحظة مهمة: لمزيد من التفاصيل عن التغييرات المرتبطة بأرقام تعريف المواضيع، يُرجى الاطّلاع على تعريف الموقع topicDetails.topicIds[] وسجلّ المراجعات.
topicDetails.topicIds[] list
قائمة بأرقام تعريف المواضيع المرتبطة بالقناة

تم إيقاف هذه السمة نهائيًا اعتبارًا من 10 تشرين الثاني (نوفمبر) 2016. وسيظل متاحًا حتى 10 تشرين الثاني (نوفمبر) 2017.

ملاحظة مهمة: بسبب إيقاف Freebase وFreebase API نهائيًا، بدأت أرقام تعريف المواضيع تعمل بشكل مختلف اعتبارًا من 27 شباط (فبراير) 2017. في ذلك الوقت، بدأت YouTube في عرض مجموعة صغيرة من معرّفات المواضيع المنظَّمة.
topicDetails.topicCategories[] list
قائمة بعناوين URL في Wikipedia التي تصف محتوى القناة
status object
يحتوي العنصر status على معلومات حول حالة خصوصية القناة.
status.privacyStatus string
حالة الخصوصية للقناة.

في ما يلي القيم الصالحة لهذه السمة:
  • private
  • public
  • unlisted
status.isLinked boolean
يشير إلى ما إذا كانت بيانات القناة تحدد مستخدمًا مرتبطًا حاليًا باسم مستخدم على YouTube أو بحساب على Google+. إذا كان لدى المستخدم أحد هذه الروابط، يعني ذلك أنّه لديه هوية علنية على YouTube، وهي شرط أساسي لتنفيذ العديد من الإجراءات، مثل تحميل الفيديوهات.
status.longUploadsStatus string
يشير هذا الخيار إلى ما إذا كانت القناة مؤهلة لتحميل فيديوهات تزيد مدّتها عن 15 دقيقة. لا يتم عرض هذه السمة إلا إذا فوّض مالك القناة طلب واجهة برمجة التطبيقات. لمزيد من المعلومات حول هذه الميزة، يُرجى الاطّلاع على مركز مساعدة YouTube.

في ما يلي القيم الصالحة لهذا السمة:
  • allowed: يمكن لهذه القناة تحميل فيديوهات تزيد مدّتها عن 15 دقيقة.
  • disallowed – لا يمكن لهذه القناة تحميل فيديوهات تزيد مدّتها عن 15 دقيقة أو ليست مؤهّلة لذلك. لا تكون القناة مؤهّلة لتحميل فيديوهات طويلة إلا إذا كانت في وضع جيد وفقًا لإرشادات المنتدى في YouTube ولم يتم حظر أي من محتوى القناة على مستوى العالم من خلال Content ID.

    بعد أن يحلّ مالك القناة المشاكل التي تمنع تحميل فيديوهات طويلة، ستعود القناة إلى الحالة allowed أو eligible.
  • eligible: هذه القناة مؤهّلة لتحميل فيديوهات تزيد مدّتها عن 15 دقيقة. ومع ذلك، على مالك القناة تفعيل إمكانية تحميل فيديوهات أطول من خلال إثبات ملكية الحساب عبر الهاتف. لمزيد من التفاصيل حول هذه الميزة، يُرجى الانتقال إلى مركز مساعدة YouTube.
status.madeForKids boolean
تشير هذه القيمة إلى ما إذا كانت القناة مصنّفة على أنّها مخصّصة للأطفال، كما تحتوي على الحالة الحالية "محتوى مخصّص للأطفال" للقناة. على سبيل المثال، قد يتم تحديد الحالة استنادًا إلى قيمة السمة selfDeclaredMadeForKids. للاطّلاع على مزيد من المعلومات حول ضبط إعدادات الجمهور لقناتك أو فيديوهاتك أو أحداث البث المباشر، يُرجى الانتقال إلى مركز مساعدة YouTube .
status.selfDeclaredMadeForKids boolean
في طلب channels.update، يسمح هذا الحقل لمالك القناة بتصنيف القناة على أنّها مخصّصة للأطفال. لا يتم عرض قيمة السمة إلا إذا فوّض مالك القناة طلب البيانات من واجهة برمجة التطبيقات.
brandingSettings object
يحتوي العنصر brandingSettings على معلومات عن العلامة التجارية للقناة.
brandingSettings.channel object
يضمّ عنصر channel سمات العلامة التجارية لصفحة القناة.
brandingSettings.channel.title string
عنوان القناة. يبلغ طول العنوان 30 حرفًا بحد أقصى.
brandingSettings.channel.description string
وصف القناة الذي يظهر في مربّع معلومات القناة على صفحتها الحد الأقصى لطول قيمة السمة هو 1,000 حرف.
brandingSettings.channel.keywords string
الكلمات الرئيسية المرتبطة بقناتك القيمة هي قائمة من السلاسل مفصولة بمسافات. قد يتم اقتطاع الكلمات الرئيسية للقنوات إذا تجاوزت الحد الأقصى المسموح به الذي يبلغ 500 حرف أو إذا كانت تحتوي على علامات اقتباس غير مشفّرة ("). يُرجى العِلم أنّ الحد الأقصى المسموح به وهو 500 حرف ليس حدًا لكل كلمة رئيسية، بل هو حدّ على إجمالي طول كل الكلمات الرئيسية.
brandingSettings.channel.trackingAnalyticsAccountId string
رقم تعريف حساب "إحصاءات Google" الذي تريد استخدامه لتتبُّع الزيارات إلى قناتك وقياسها.
brandingSettings.channel.unsubscribedTrailer string
الفيديو الذي يجب تشغيله في وحدة الفيديو المميّز في طريقة العرض "التصفّح" في صفحة القناة للمشاهدين غير المشتركين فيها. قد يظهر للمشتركين فيديو مختلف يسلّط الضوء على نشاط أحدث في القناة.

في حال تحديدها، يجب أن تكون قيمة السمة هي معرّف فيديو YouTube الخاص بفيديوه علني أو غير مُدرَج يملكه مالك القناة.
brandingSettings.channel.defaultLanguage string
هي لغة النص في السمتَين snippet.title وsnippet.description لمصدر channel.
brandingSettings.channel.country string
البلد المرتبط بالقناة عدِّل هذا السمة لضبط قيمة السمة snippet.country.
brandingSettings.watch object
ملاحظة: تم إيقاف هذا العنصر وجميع المواقع الفرعية نهائيًا.

يضمّ عنصر watch سمات العلامة التجارية لصفحات مشاهدة فيديوهات القناة.
brandingSettings.watch.textColor string
ملاحظة: تم إيقاف هذه السمة نهائيًا.

لون النص في المنطقة التي تعرض العلامة التجارية في صفحة مشاهدة الفيديو
brandingSettings.watch.backgroundColor string
ملاحظة: تم إيقاف هذه السمة نهائيًا.

لون خلفية المنطقة التي تعرض العلامة التجارية في صفحة مشاهدة الفيديو.
brandingSettings.watch.featuredPlaylistId string
ملاحظة: تم إيقاف هذه السمة نهائيًا. ستعرض واجهة برمجة التطبيقات رسالة خطأ إذا حاولت ضبط قيمتها.
brandingSettings.image object
تم إيقاف هذا الموقع الإلكتروني وجميع المواقع الإلكترونية الفرعية نهائيًا.

يحتوي العنصر image على معلومات عن الصور التي تظهر على صفحة القناة أو صفحات مشاهدة الفيديوهات.
brandingSettings.image.bannerImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة البانر المعروضة على صفحة القناة على موقع YouTube الإلكتروني. أبعاد الصورة هي 1060 × 175 بكسل.
brandingSettings.image.bannerMobileImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة البانر المعروضة على صفحة القناة في التطبيقات المتوافقة مع الأجهزة الجوّالة. أبعاد الصورة هي 640 × 175 بكسل.
brandingSettings.image.watchIconImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL للصورة التي تظهر أعلى مشغّل الفيديو. هذه صورة بارتفاع 25 بكسل وعرض مرن لا يمكن أن يتجاوز 170 بكسل. في حال عدم تقديم هذه الصورة، سيظهر اسم قناتك بدلاً منها.
brandingSettings.image.trackingImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لوحدة بكسل تتبُّع بحجم 1 بكسل في 1 بكسل يمكن استخدامها لجمع إحصاءات عن مشاهدات صفحات القناة أو الفيديو.
brandingSettings.image.bannerTabletLowImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر منخفضة الدقة يتم عرضها على صفحة القناة في تطبيقات الأجهزة اللوحية. الحد الأقصى لحجم الصورة هو 1138 بكسل × 188 بكسل.
brandingSettings.image.bannerTabletImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر تظهر على صفحة القناة في تطبيقات الأجهزة اللوحية. أبعاد الصورة هي 1707 بكسل × 283 بكسل.
brandingSettings.image.bannerTabletHdImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر عالية الدقة يتم عرضها على صفحة القناة في تطبيقات الأجهزة اللوحية. الحد الأقصى لحجم الصورة هو 2276 بكسل × 377 بكسل.
brandingSettings.image.bannerTabletExtraHdImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر عالية الدقة جدًا يتم عرضها على صفحة القناة في تطبيقات الأجهزة اللوحية. الحد الأقصى لحجم الصورة هو 2560 بكسل × 424 بكسل.
brandingSettings.image.bannerMobileLowImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر ذات دقة منخفضة يتم عرضها على صفحة القناة في التطبيقات المتوافقة مع الأجهزة الجوّالة. الحد الأقصى لحجم الصورة هو 320 بكسل × 88 بكسل.
brandingSettings.image.bannerMobileMediumHdImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر بدرجة دقة متوسطة يتم عرضها على صفحة القناة في التطبيقات المتوافقة مع الأجهزة الجوّالة. الحد الأقصى لحجم الصورة هو 960 بكسل × 263 بكسل.
brandingSettings.image.bannerMobileHdImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر عالية الدقة يتم عرضها على صفحة القناة في التطبيقات المتوافقة مع الأجهزة الجوّالة. الحد الأقصى لحجم الصورة هو 1280 بكسل × 360 بكسل.
brandingSettings.image.bannerMobileExtraHdImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر عالية الدقة جدًا يتم عرضها على صفحة القناة في التطبيقات المتوافقة مع الأجهزة الجوّالة. الحد الأقصى لحجم الصورة هو 1440 بكسل × 395 بكسل.
brandingSettings.image.bannerTvImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر بدقة عالية جدًا يتم عرضها على صفحة القناة في تطبيقات التلفزيون. الحد الأقصى لحجم الصورة هو 2120 بكسل × 1192 بكسل.
brandingSettings.image.bannerTvLowImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر ذات درجة دقة منخفضة يتم عرضها على صفحة القناة في تطبيقات التلفزيون. الحد الأقصى لحجم الصورة هو 854 بكسل × 480 بكسل.
brandingSettings.image.bannerTvMediumImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر بدرجة دقة متوسطة يتم عرضها على صفحة القناة في تطبيقات التلفزيون. الحد الأقصى لحجم الصورة هو 1280 بكسل × 720 بكسل.
brandingSettings.image.bannerTvHighImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر عالية الدقة يتم عرضها على صفحة القناة في تطبيقات التلفزيون. الحد الأقصى لحجم الصورة هو 1920 بكسل × 1080 بكسل.
brandingSettings.image.bannerExternalUrl string
تحدد هذه السمة موقع صورة البانر التي تستخدمها YouTube لإنشاء أحجام مختلفة لصورة البانر في القناة.
brandingSettings.hints[] list
تم إيقاف هذا الموقع الإلكتروني وجميع المواقع الإلكترونية الفرعية نهائيًا.

يحوي عنصر hints سمات إضافية خاصة بالعلامة التجارية.
brandingSettings.hints[].property string
تم إيقاف هذه السمة نهائيًا.

موقع.
brandingSettings.hints[].value string
تم إيقاف هذه السمة نهائيًا.

قيمة السمة.
auditDetails object
يحتوي العنصر auditDetails على بيانات القناة التي ستقيّمها شبكة متعددة القنوات (MCN) عند تحديد ما إذا كانت ستقبل قناة معيّنة أو ترفضها. يُرجى العلم أنّ أي طلب بيانات من واجهة برمجة التطبيقات يسترجع جزء المورد هذا يجب أن يقدّم رمز موافقة مميزًا يحتوي على نطاق https://www.googleapis.com/auth/youtubepartner-channel-audit. بالإضافة إلى ذلك، يجب إلغاء أي رمز مميّز يستخدم هذا النطاق عندما تقرّر الشبكة المتعددة القنوات قبول القناة أو رفضها أو خلال أسبوعَين من تاريخ إصدار الرمز المميّز.
auditDetails.overallGoodStanding boolean
يشير هذا الحقل إلى ما إذا كانت هناك أي مشاكل في القناة. يمثّل هذا الحقل حاليًا نتيجة العملية المنطقية AND على السمات communityGuidelinesGoodStanding وcopyrightStrikesGoodStanding وcontentIdClaimsGoodStanding، ما يعني أنّ هذه السمة لها قيمة true إذا كانت جميع هذه السمات الأخرى لها أيضًا قيمة true. ومع ذلك، ستكون قيمة هذا الموقع هي false إذا كانت قيمة أيّ من هذه المواقع هي false. يُرجى العلم أنّ المنهجية المستخدَمة لضبط قيمة هذه السمة تخضع للتغيير.
auditDetails.communityGuidelinesGoodStanding boolean
يشير هذا الرمز إلى ما إذا كانت القناة تلتزم بإرشادات المنتدى في YouTube.
auditDetails.copyrightStrikesGoodStanding boolean
يشير هذا الحقل إلى ما إذا كانت القناة قد تلقّت أي إنذارات بسبب انتهاك حقوق الطبع والنشر.
auditDetails.contentIdClaimsGoodStanding boolean
يشير إلى ما إذا كانت القناة تضم أي مطالبات لم يتم حلّها.
contentOwnerDetails object
يضمّ عنصر contentOwnerDetails بيانات القناة التي لا تظهر إلا لشريك YouTube الذي ربط القناة بحسابه في "إدارة المحتوى".
contentOwnerDetails.contentOwner string
رقم تعريف مالك المحتوى المرتبط بالقناة.
contentOwnerDetails.timeLinked datetime
تاريخ ووقت ربط القناة بحساب مالك المحتوى يتم تحديد القيمة بتنسيق ISO 8601.
localizations object
يتضمّن عنصر localizations ترجمات البيانات الوصفية للقناة.
localizations.(key) object
لغات البيانات الوصفية المترجَمة المرتبطة بقيمة المفتاح القيمة هي سلسلة تحتوي على رمز لغة BCP-47.
localizations.(key).title string
عنوان القناة المترجَم
localizations.(key).description string
وصف القناة المترجَم