Search

تتضمّن نتيجة البحث معلومات عن فيديو أو قناة أو قائمة تشغيل على YouTube تتطابق مع مَعلمات البحث المحدّدة في طلب بيانات من واجهة برمجة التطبيقات. فيما تشير نتيجة البحث إلى مورد يمكن التعرّف عليه بشكل فريد، مثل فيديو، لا تكون هناك بيانات ثابتة خاصة به.

الطُرق

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

list
عرض مجموعة من نتائج البحث التي تتطابق مع معلَمات طلب البحث المحدّدة في طلب البيانات من واجهة برمجة التطبيقات. تحدِّد مجموعة نتائج البحث تلقائيًا موارد video وchannel وplaylist المطابقة، ولكن يمكنك أيضًا إعداد طلبات البحث لاسترداد نوع محدّد فقط من الموارد. التجربة الآن

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

تعرض بنية JSON التالية تنسيق نتيجة البحث:

{
  "kind": "youtube#searchResult",
  "etag": etag,
  "id": {
    "kind": string,
    "videoId": string,
    "channelId": string,
    "playlistId": string
  },
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "liveBroadcastContent": string
  }
}

أماكن إقامة

يعرّف الجدول التالي السمات التي تظهر في نتيجة بحث:

أماكن إقامة
kind string
يحدّد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#searchResult.
etag etag
علامة هذا المرجع.
id object
يحتوي الكائن id على معلومات يمكن استخدامها لتحديد المورد الذي يطابق طلب البحث بشكل فريد.
id.kind string
نوع مورد واجهة برمجة التطبيقات.
id.videoId string
إذا كانت قيمة السمة id.type هي youtube#video، ستكون هذه السمة متوفّرة وستتضمّن قيمتها المعرّف الذي تستخدمه منصة YouTube لتحديد الفيديو الذي يتطابق مع طلب البحث بشكل فريد.
id.channelId string
إذا كانت قيمة السمة id.type هي youtube#channel، ستكون هذه السمة متوفّرة وستتضمّن قيمتها المعرّف الذي تستخدمه منصة YouTube لتحديد قناة تتطابق مع طلب البحث بشكل فريد.
id.playlistId string
إذا كانت قيمة السمة id.type هي youtube#playlist، ستكون هذه السمة متوفّرة وستتضمّن قيمتها المعرّف الذي تستخدمه منصة YouTube لتحديد قائمة تشغيل تتطابق مع طلب البحث بشكل فريد.
snippet object
يحتوي العنصر snippet على تفاصيل أساسية حول نتيجة بحث، مثل عنوانها أو وصفها. على سبيل المثال، إذا كانت نتيجة البحث عبارة عن فيديو، يكون العنوان هو عنوان الفيديو وسيكون الوصف هو وصف الفيديو.
snippet.publishedAt datetime
تاريخ ووقت إنشاء المورد الذي تحدِّده نتيجة البحث. ويتم تحديد القيمة بتنسيق ISO 8601.
snippet.channelId string
القيمة التي تستخدمها YouTube لتحديد القناة التي نشرت المورد المحدد في نتيجة البحث بشكل فريد.
snippet.title string
عنوان نتيجة البحث.
snippet.description string
وصف لنتيجة البحث
snippet.thumbnails object
خريطة للصور المصغّرة المرتبطة بنتيجة البحث بالنسبة لكل كائن في الخريطة، يكون المفتاح هو اسم الصورة المصغرة، والقيمة هي كائن يحتوي على معلومات أخرى حول الصورة المصغرة.
snippet.thumbnails.(key) object
في ما يلي قيم المفاتيح الصالحة:
  • default – الصورة المصغّرة التلقائية الصورة المصغّرة الافتراضية للفيديو - أو مورد يشير إلى فيديو، مثل عنصر قائمة تشغيل أو نتيجة بحث - هو عرض يبلغ 120 بكسل وطول 90 بكسل. الصورة المصغّرة الافتراضية للقناة هي عرض 88 بكسل وطول 88 بكسل.
  • medium – نسخة بدرجة دقة أعلى من الصورة المصغّرة بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يكون عرض هذه الصورة 320 بكسل وطولها 180 بكسل. بالنسبة إلى القناة، يكون عرض هذه الصورة 240 بكسل وطولها 240 بكسل.
  • high – نسخة عالية الدقة من الصورة المصغّرة بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يكون عرض هذه الصورة 480 بكسل وطولها 360 بكسل. بالنسبة إلى القناة، يكون عرض هذه الصورة 800 بكسل وطول 800 بكسل.
  • standard – نسخة بدرجة دقة أعلى من الصورة المصغّرة بدرجة دقة high. تتوفر هذه الصورة لبعض الفيديوهات وموارد أخرى تشير إلى الفيديوهات، مثل عناصر قوائم التشغيل أو نتائج البحث. يبلغ عرض هذه الصورة 640 بكسل وطولها 480 بكسل.
  • maxres – النسخة الأعلى دقة من الصورة المصغّرة يتوفر هذا الحجم من الصورة لبعض الفيديوهات وموارد أخرى تشير إلى الفيديوهات، مثل عناصر قوائم التشغيل أو نتائج البحث. يبلغ عرض هذه الصورة 1280 بكسل وطولها 720 بكسل.
snippet.thumbnails.(key).url string
عنوان URL للصورة:
snippet.thumbnails.(key).width unsigned integer
عرض الصورة.
snippet.thumbnails.(key).height unsigned integer
ارتفاع الصورة.
snippet.channelTitle string
عنوان القناة التي نشرت المرجع الذي تحدّده نتيجة البحث
snippet.liveBroadcastContent string
إشارة إلى ما إذا كان مورد video أو channel يتضمن محتوى بث مباشر قيم السمات الصالحة هي upcoming وlive وnone.

بالنسبة إلى مورد video، تشير القيمة upcoming إلى أنّ الفيديو هو بث مباشر لم يبدأ بعد، بينما تشير القيمة live إلى أنّ الفيديو هو بث مباشر نشط. بالنسبة إلى مورد channel، تشير القيمة upcoming إلى أنّ القناة تعرض بثًا مباشرًا مجدولاً لم يبدأ بعد، بينما تشير القيمة live إلى أنّ القناة لديها بث مباشر نشط.