تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Comments

يحتوي مورد comment على معلومات عن تعليق واحد على YouTube. يمكن أن يمثّل مرجع comment تعليقًا حول فيديو أو قناة. بالإضافة إلى ذلك، يمكن أن يكون التعليق تعليقًا من المستوى الأعلى أو ردًا على تعليق من المستوى الأعلى.

الطُرق

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

list: تعرض قائمة بالتعليقات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
إدراج: إنشاء ردّ على تعليق حالي ملاحظة: لإنشاء تعليق من المستوى الأعلى، استخدِم الطريقة commentThreads.insert. جرِّب ذلك الآن.
تعديل: تعديل تعليق التجربة الآن
حذف: لحذف تعليق: التجربة الآن
setModerationStatus: تُستخدَم لضبط حالة الإشراف على تعليق واحد أو أكثر. يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات مفوَّضًا من قِبل مالك القناة أو الفيديو المرتبط بالتعليقات. التجربة الآن
markAsSpam: ملاحظة: تم إيقاف هذه الطريقة نهائيًا ولم يعُد استخدامها مسموحًا به.; يعبّر عن رأي المتصل بأنّه يجب الإبلاغ عن تعليق واحد أو أكثر كمحتوى غير مرغوب فيه.

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

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

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime
  }
}

أماكن إقامة

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

أماكن إقامة
`kind`	`string` لتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة `youtube#comment`.
`etag`	`etag` رقم تعريف Etag لهذا المورد.
`id`	`string` المعرّف الذي تستخدمه YouTube لتحديد التعليق بشكل فريد
`snippet`	`object` يحتوي عنصر `snippet` على تفاصيل أساسية عن التعليق.
`snippet.authorDisplayName`	`string` الاسم المعروض للمستخدم الذي نشر التعليق.
`snippet.authorProfileImageUrl`	`string` عنوان URL لأفاتار المستخدم الذي نشر التعليق.
`snippet.authorChannelUrl`	`string` عنوان URL لقناة YouTube الخاصة بصاحب التعليق، إذا كان متوفّرًا
`snippet.authorChannelId`	`object` يتضمن هذا العنصر معلومات عن قناة مؤلف التعليق على YouTube، إن توفّرت.
`snippet.authorChannelId.value`	`string` معرّف قناة صاحب التعليق على YouTube، إذا كان متاحًا
`snippet.channelId`	`string` معرّف قناة YouTube المرتبطة بالتعليق.
`snippet.textDisplay`	`string` نص التعليق. يمكن استرداد النص بتنسيق نص عادي أو HTML. (تتوافق الطريقتان `comments.list` و`commentThreads.list` مع المَعلمة `textFormat` التي تحدّد تنسيق النص المحدّد.) قد يختلف النص العادي عن نص التعليق الأصلي. على سبيل المثال، قد تستبدل الروابط المؤدية إلى الفيديوهات بعناوين الفيديوهات.
`snippet.textOriginal`	`string` النص الأصلي للتعليق كما تم نشره في البداية أو تاريخ آخر تعديل له. لا يتم عرض النص الأصلي إلا للمستخدم الذي تمّت المصادقة عليه إذا كان كاتب التعليق.
`snippet.parentId`	`string` المعرّف الفريد للتعليق الرئيسي لا يتم ضبط هذه السمة إلا إذا تم إرسال التعليق كردّ على تعليق آخر.
`snippet.canRate`	`boolean` يشير هذا الإعداد إلى ما إذا كان بإمكان المشاهد الحالي تقييم التعليق.
`snippet.viewerRating`	`string` التقييم الذي منحه المشاهد لهذا التعليق. لا يحدِّد هذا الموقع تقييمات `dislike`، ولكن هذا السلوك يخضع للتغيير. في هذه الأثناء، تكون قيمة السمة `like` إذا قدّم المشاهد تقييمًا إيجابيًا للتعليق. تكون القيمة `none` في جميع الحالات الأخرى، بما في ذلك الحالات التي يقدّم فيها المستخدم تقييمًا سلبيًا للتعليق أو لا يقدّم أي تقييم له. القيم الصالحة لهذه السمة هي: `like` `none`
`snippet.likeCount`	`unsigned integer` إجمالي عدد المعجبين (التقييمات الإيجابية) الذين أبدوا إعجابهم بالتعليق.
`snippet.moderationStatus`	`string` حالة الإشراف على التعليق. لا يتم عرض هذه السمة إلا إذا وافق مالك القناة أو الفيديو الذي تم نشر التعليقات المطلوبة عليه على طلب البيانات من واجهة برمجة التطبيقات. ولا يتمّ ضبط هذه السمة أيضًا إذا كان طلب واجهة برمجة التطبيقات يستخدم مَعلمة الفلتر `id`. القيم الصالحة لهذه السمة هي: `heldForReview` `likelySpam` `published` `rejected`
`snippet.publishedAt`	`datetime` التاريخ والوقت اللذان تم فيهما نشر التعليق الأصلي يتم تحديد القيمة بتنسيق ISO 8601.
`snippet.updatedAt`	`datetime` تاريخ ووقت آخر تعديل على التعليق يتم تحديد القيمة بتنسيق ISO 8601.