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 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 إلى أنّ القناة نشطة للبث المباشر.