Channels

تتيح واجهة برمجة التطبيقات الآن تصنيف قناتك أو فيديوهاتك على أنّها "مخصّصة للأطفال". فضلاً عن ذلك، تتضمّن المراجعان channel وvideo الآن سمة تحدّد حالة "محتوى مخصّص للأطفال" في القناة أو الفيديو المعنيّ. تم أيضًا تعديل بنود الخدمة وسياسات المطوّرين في YouTube API في 10 كانون الثاني (يناير) 2020. للمزيد من المعلومات، يُرجى الاطّلاع على سجلّات النُسخ السابقة من خدمة Data API في YouTube وبنود الخدمة في 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
علامة هذا المرجع.
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 للصورة: اطّلِع على تعريف السمة snippet.thumbnails للحصول على إرشادات إضافية عن استخدام عناوين URL للصور المصغّرة في تطبيقك.
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 دقيقة. مع ذلك، يجب أن يفعّل مالك القناة أولاً ميزة تحميل فيديوهات أطول على https://www.youtube.com/verify. يمكنك الاطّلاع على مركز مساعدة 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
وصف القناة المترجَم