⚡ فهرسة فورية بواسطة Google Indexing API

الدليل الكامل: كيف تفهرس موقعك فوراً عبر Google Indexing API خطوة بخطوة

إذا كنت تدير موقعاً إلكترونياً وتنتظر أياماً أو حتى أسابيع حتى تظهر صفحاتك الجديدة في نتائج بحث Google، فإن هذا الدليل سيغيّر الطريقة التي تتعامل بها مع الفهرسة إلى الأبد. بدلاً من الاعتماد فقط على زحف Googlebot العشوائي الذي قد يستغرق وقتاً طويلاً ليكتشف صفحاتك الجديدة أو المُحدَّثة، توفّر Google واجهة برمجية رسمية تسمى Indexing API تتيح لك إخبار Google مباشرة: "هذه الصفحة جاهزة، تفضّل بفهرستها الآن". في هذا الدليل سنشرح كل خطوة بالتفصيل، من إنشاء مشروع في Google Cloud حتى إرسال أول طلب فهرسة ناجح باستخدام الأداة المدمجة أعلاه.

لماذا الفهرسة الفورية أهم مما تتخيل؟

محرك بحث Google يعمل عبر برامج زحف (Crawlers) تتجول بين مليارات الصفحات باستمرار، لكن هذا الزحف له أولويات وموارد محدودة. الموقع الجديد أو الصفحة المُحدَّثة حديثاً قد لا تحظى بجولة زحف قريبة، خصوصاً إن كان الموقع لا يزال يبني سمعته لدى محرك البحث. النتيجة: محتوى ممتاز يبقى غير مرئي لأسابيع، وفرصة ترتيب ضائعة في أهم نافذة زمنية — أول أيام نشر المحتوى، حين يكون الاهتمام والمنافسة على الكلمة المفتاحية في أعلى مستوياتها.

هنا يأتي دور Indexing API: بدلاً من الانتظار السلبي، ترسل إشعاراً مباشراً لخوادم Google بعنوان الصفحة (URL) طالباً منها الزحف والفهرسة فوراً. الفارق ملموس جداً في المواقع الإخبارية، صفحات التطبيقات (Application Pages)، والقوائم التي تتغيّر باستمرار — بالضبط النوع الذي يديره موقع مثل yassota.

الخطوة 1: إنشاء مشروع في Google Cloud Console

ابدأ بزيارة console.cloud.google.com وتسجيل الدخول بحساب Google الخاص بك (يفضّل استخدام نفس الحساب المرتبط بـ Search Console لموقعك لاحقاً، رغم أن هذا ليس شرطاً إلزامياً). من القائمة العلوية اضغط على منتقي المشاريع (Project Selector) ثم "مشروع جديد" (New Project). اختر اسماً واضحاً مثل yassota-indexing ليسهل عليك تمييزه لاحقاً، ثم اضغط "إنشاء" (Create) وانتظر بضع ثوانٍ حتى يكتمل الإعداد.

الخطوة 2: تفعيل واجهة Indexing API

بعد اختيار مشروعك، اذهب إلى "مكتبة الواجهات البرمجية" (APIs & Services ← Library) من القائمة الجانبية. في مربع البحث اكتب Indexing API واختر النتيجة الرسمية من Google، ثم اضغط زر "تفعيل" (Enable). هذه الخطوة إلزامية — بدونها ستفشل كل الطلبات لاحقاً برسالة "API not enabled" حتى لو كانت بياناتك صحيحة تماماً.

الخطوة 3: إنشاء حساب خدمة (Service Account) وتنزيل ملف JSON

حساب الخدمة هو "هوية آلية" تستخدمها الأداة للتحدث مع Google نيابة عنك، بدون الحاجة لتسجيل دخولك يدوياً في كل مرة. من نفس القسم اذهب إلى "بيانات الاعتماد" (Credentials) ← "إنشاء بيانات اعتماد" (Create Credentials) ← "حساب خدمة" (Service Account). أدخل اسماً وصفياً، تخطَّ خطوات الأدوار الاختيارية (Roles) بالضغط على "متابعة" ثم "تم"، لأن الأداة لا تحتاج صلاحيات إضافية داخل المشروع نفسه.

بعد إنشاء حساب الخدمة، ستجده في قائمة الحسابات — اضغط عليه، ثم انتقل لتبويب "المفاتيح" (Keys) ← "إضافة مفتاح" (Add Key) ← "إنشاء مفتاح جديد" (Create New Key) واختر صيغة JSON (وليس P12). سيُنزَّل ملف بامتداد .json تلقائياً على جهازك — هذا هو الملف الذي ستلصق محتواه في الأداة أعلاه. احتفظ به في مكان آمن ولا تشاركه مع أي أحد، لأنه يمنح صلاحية كاملة للتصرف نيابة عن هذا الحساب.

الخطوة 4: إضافة حساب الخدمة كمالك (Owner) في Search Console

هذه الخطوة هي التي يغفل عنها كثيرون فتفشل طلباتهم لاحقاً. حساب الخدمة الذي أنشأته له عنوان بريد إلكتروني آلي (يظهر داخل ملف JSON تحت الحقل client_email، وعادة يكون على الشكل xxx@your-project.iam.gserviceaccount.com). يجب إضافة هذا البريد كـ مالك (Owner) — وليس مستخدماً عادياً أو محرراً — داخل خاصية موقعك على Google Search Console.

لفعل ذلك: افتح Search Console ← اختر ملكية موقعك (yassota.com) ← الإعدادات ← "مستخدمون وأذونات" (Users and Permissions) ← "إضافة مستخدم" (Add User) ← الصق بريد حساب الخدمة الآلي ← اختر الصلاحية "مالك" (Owner) تحديداً، فالصلاحيات الأقل (مثل "كامل" Full) لا تكفي لعمليات Indexing API. احفظ، وانتظر بضع دقائق حتى تُفعَّل الصلاحية على خوادم Google.

الخطوة 5: استخدام الأداة — الصق، استورد، أرسل

الآن افتح ملف .json الذي نزّلته بمحرر نصوص (Notepad أو أي محرر بسيط)، انسخ محتواه بالكامل من القوس الأول { حتى القوس الأخير }، والصقه في مربع "ملف JSON" بالأداة أعلاه. بعدها أضف روابط الصفحات التي تريد فهرستها في المربع الثاني، سطراً بسطر، مثل:

yassota.com/chatgpt-apk
https://yassota.com/sitemap.php

لاحظ أنك لست مضطراً لكتابة كل رابط يدوياً — بمجرد الضغط على زر "استيراد كل المسارات تلقائياً من Sitemap.php" ستقوم الأداة بجلب ملف خريطة الموقع الفعلي وسحب كل الروابط الموجودة فيه دفعة واحدة، وهذا يشمل تلقائياً أي صفحة HTML جديدة تُضاف من قسم "رفع صفحات HTML" بلوحة التحكم، لأنها تُدرَج بالـ sitemap تلقائياً عند نشرها. لا يُشترط أن يتجاوز محتوى كل صفحة عدداً معيناً من الأحرف لإرسالها — الهدف هنا هو سرعة الفهرسة وليس تقييم جودة المحتوى (ذلك تكفّلت به أداة "تقييم جودة الصفحة" في قسم رفع HTML بشكل منفصل).

ماذا يحدث بعد الضغط على "إرسال للفهرسة الآن"؟

تقوم الأداة خلف الكواليس بثلاث خطوات تلقائية: أولاً، تبني ما يُسمى JWT (رمز ويب موقّع) باستخدام المفتاح الخاص الموجود داخل ملف JSON الذي لصقته، وتوقّعه رقمياً بخوارزمية RS256. ثانياً، تتبادل هذا الرمز الموقّع مع خادم Google للحصول على "رمز وصول" (Access Token) صالح لمدة ساعة واحدة فقط لأسباب أمنية. ثالثاً، ترسل كل رابط من قائمتك في طلب منفصل إلى نقطة النهاية الرسمية indexing.googleapis.com/v3/urlNotifications:publish مرفقاً برمز الوصول هذا. النتيجة تظهر لك فوراً تحت الأداة: علامة ✅ خضراء لكل رابط نجح إرساله، أو رسالة الخطأ الدقيقة القادمة من Google نفسها إن فشل أحدها (غالباً بسبب صلاحية غير مضبوطة أو رابط لا ينتمي لملكية موقعك المُتحقق منها في Search Console).

حدود الاستخدام: لماذا 100 عملية فقط في الباقة المجانية؟

من المهم التمييز بين نوعين من الحدود هنا. الأول هو حد yassota الداخلي: نمنح كل زائر جديد 100 عملية فهرسة مجانية تُحتسب تلقائياً عبر ملف تعريف ارتباط (Cookie) طويل الأمد، وهذا الرقم كافٍ تماماً لغالبية المواقع الصغيرة والمتوسطة عند إطلاق موقع جديد أو صفحة تحديثات كبيرة. الثاني هو حد Google نفسها على مستوى حساب الخدمة/المشروع — وهو حد منفصل تفرضه Google بغض النظر عن أداتنا، ويمكن مراجعته وزيادته (إن لزم) من داخل Google Cloud Console تحت قسم "الحصص" (Quotas) الخاص بواجهة Indexing API. إن استهلكت رصيدك المجاني هنا في yassota، ستحتاج للترقية لإحدى الباقات المدفوعة أعلاه (المتاحة قريباً) لمواصلة استخدام الأداة دون قيود.

أخطاء شائعة وكيفية تفاديها

أكثر الأخطاء تكراراً هي: (١) نسيان تفعيل Indexing API نفسها من مكتبة الواجهات البرمجية رغم إنشاء حساب الخدمة بنجاح، وهذا يظهر برسالة "API has not been used in project"؛ (٢) إضافة حساب الخدمة بصلاحية أقل من "مالك" في Search Console، فيظهر خطأ "Permission denied"؛ (٣) محاولة فهرسة رابط لا ينتمي لملكية مُتحقق منها أصلاً في حسابك على Search Console؛ و(٤) لصق محتوى ملف JSON بشكل غير مكتمل (مثلاً نسيان قوس الإغلاق الأخير)، فتفشل الأداة في قراءته من الأساس. كل هذه الحالات تظهر لك برسالة خطأ واضحة من الأداة تحدد المشكلة بدقة بدل رسالة عامة غامضة.

أسئلة شائعة

هل Indexing API يعمل مع كل أنواع الصفحات؟
رسمياً، وثّقت Google هذه الواجهة في الأساس لصفحات نوعين: صفحات الوظائف (Job Postings) وصفحات البث المباشر (Livestream). عملياً، تقبل الواجهة إرسال أي رابط من ملكية مُتحقق منها وتعالجه، وكثير من أصحاب المواقع (بما فيهم مواقع تنزيل التطبيقات كـ yassota) يستخدمونها بنجاح لتسريع فهرسة صفحات المقالات وصفحات التطبيقات العادية. النتيجة قد تكون فهرسة أسرع، لكن Google تحتفظ دوماً بحقها في تقييم جودة الصفحة قبل تثبيتها في نتائج البحث — الأداة تضمن "الاكتشاف" السريع فقط، وليست ضماناً للترتيب.

هل يمكنني استخدام نفس ملف JSON لعدة مواقع؟
نعم، طالما أن بريد حساب الخدمة نفسه مُضاف كمالك (Owner) في خاصية Search Console الخاصة بكل موقع تريد إرسال روابط منه. مشروع Google Cloud واحد يمكن أن يخدم عدة مواقع مملوكة لك بنفس المفتاح.

ظهرت رسالة "Quota exceeded" رغم أن رصيدي هنا لم ينفد، ماذا أفعل؟
هذه رسالة قادمة من Google مباشرة (وليس من نظام yassota) وتعني أنك تجاوزت الحصة اليومية التي يحددها Google لحساب الخدمة نفسه، وهي منفصلة تماماً عن رصيد الـ 100 عملية هنا. يمكن مراجعة هذه الحصة وطلب زيادتها من قسم "IAM & Admin ← Quotas" داخل Google Cloud Console، بالبحث عن اسم الواجهة "Web Search indexing API".

هل الأداة آمنة على مفتاح JSON الخاص بي؟
لديك خياران: اللصق السريع في المربع بدون ضغط زر "اتصال دائم" يُستخدم لحظة الإرسال فقط ولا يُحفظ. أما "الاتصال الدائم" (رفع الملف مرة واحدة) فيُخزَّن بقاعدة بيانات الموقع حتى لا تُضطر لتكراره — لهذا نتحقق منه فعلياً مع Google قبل حفظه، ويمكنك فصل الاتصال وحذفه نهائياً في أي وقت بضغطة زر. كقاعدة أمنية عامة، يُنصح دوماً بعدم مشاركة مفتاح حساب خدمة نشِط مع أي طرف لا تثق به تماماً — لأنه يمنح صلاحية تصرف كاملة نيابة عن ذلك الحساب.

ما الفرق بين هذه الأداة وإرسال Sitemap العادي من Search Console؟
إرسال خريطة الموقع (Sitemap) عبر Search Console يخبر Google بوجود قائمة روابط ليزحفها ضمن جدولته العادية — لا يوجد ضمان بموعد الزحف الفعلي، وقد يستغرق أياماً. أما Indexing API فهو طلب فهرسة فوري ومباشر لكل رابط على حدة، مصمم أصلاً لحالات تتطلب سرعة استجابة عالية. الأفضل عملياً هو استخدام الاثنين معاً: خريطة الموقع كخط أساس شامل ومستمر، وهذه الأداة كدفعة تسريع فورية عند نشر محتوى جديد أو مهم.

الفهرسة الفورية عبر Google Indexing API ليست حيلة أو اختراقاً لخوارزميات جوجل — هي واجهة رسمية موثّقة توفّرها Google نفسها لأصحاب المواقع الجادين الذين يريدون التحكم بسرعة ظهور محتواهم. الإعداد الأولي يستغرق بضع دقائق فقط في أول مرة (إنشاء المشروع، تفعيل الواجهة، إنشاء المفتاح، وربطه بـ Search Console)، وبعدها تصبح كل عملية فهرسة لاحقة مسألة لصق ملف JSON مرة واحدة وضغطة زر واحدة — سواء لرابط واحد أو لملف Sitemap كامل يحتوي مئات الروابط دفعة واحدة.