تمت ترجمة هذه الصفحة بواسطة 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` تشير هذه السمة إلى علامة هذا المورد.
`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.