تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
وكيل المستخدم APIs-Google
APIs-Google هو وكيل المستخدم الذي تستخدمه أداة Google APIs لعرض رسائل الإشعارات الفورية.
ويمكن لمطوّري التطبيقات طلب هذه الإشعارات لتجنُّب الحاجة إلى الرجوع إلى خوادم Google باستمرار لمعرفة
ما إذا كان قد تم تغيير الموارد التي تهمّهم أم لا.
للتأكّد من عدم إساءة استخدام هذه الخدمة، تطلب Google من المطوّرين إثبات ملكية
النطاق قبل السماح لهم بتسجيل عنوان URL على نطاق ما على أنه الموقع الذي
يريدون تلقّي الرسائل فيه.
كيفية وصول APIs-Google إلى موقعك الإلكتروني
ترسل أداة APIs-Google كل إشعار فوري باستخدام طلب HTTPS POST. إذا تعذّر الطلب بسبب
حالة خطأ قد تكون مؤقتة، سيعيد APIs-Google إرسال الإشعار. وفي حال
استمرّ تعذُّر إرسال الطلب، سيواصل APIs-Google إعادة المحاولة استنادًا إلى جدول زمني للتراجع الأسي،
وذلك لعدة أيام كحد أقصى.
ويختلف معدّل وصول APIs-Google إلى موقعك الإلكتروني حسب عدد طلبات الإشعارات الفورية التي
تم إنشاؤها للخوادم على موقعك الإلكتروني، ومدى سرعة تعديل الموارد المراقَبة،
وعدد عمليات إعادة المحاولة الجارية. ونتيجة لذلك، يمكن أن تكون أنماط زيارات APIs-Google
متّسقة في بعض السيناريوهات، ويمكن أيضًا أن تكون الزيارات متقطّعة أو تشهد ارتفاعًا مفاجئًا في سيناريوهات أخرى.
تحضير موقعك الإلكتروني لوصول APIs-Google إليه
يستخدم APIs-Google بروتوكول HTTPS لعرض الإشعارات الفورية، لذلك فهو يتطلّب أن يكون موقعك الإلكتروني حاصلاً على
شهادة طبقة مقابس آمنة (SSL) صالحة. تتضمن الشهادات غير الصالحة ما يلي:
- الشهادات الموقَّعة ذاتيًا.
- الشهادات الموقَّعة من مصدر غير موثوق به.
- الشهادات التي تم إبطالها.
يمكنك تجنّب طلبات إعادة المحاولة غير الضرورية من خلال التأكد من أنّ تطبيقك مصمّم بشكل جيد وأنه
يستجيب فورًا لرسائل الإشعارات (خلال ثوانٍ).
منع APIs-Google من طلب الزحف إلى موقعك الإلكتروني
لمنع APIs-Google من طلب الزحف إلى موقعك الإلكتروني، يمكنك تنفيذ أحد الإجراءين التاليَين:
-
إلغاء التسجيل في تلقّي الإشعارات: إذا كنت تشرف على أحد النطاقات التي تتضمن
نطاقات فرعية أو مسافات فرعية لعناوين URL مملوكة أو يتم الإشراف عليها بشكل منفصل، يُحتمَل أنّ أحد مالكي النطاق الفرعي
قد أعدّ تطبيقًا يستخدم الإشعارات الفورية. إذا أردت منع وصول
APIs-Google إلى موقعك الإلكتروني، تواصَل مع المستخدم الذي قد يكون أعدّ تطبيقًا من هذا النوع واطلب منه
إيقافه.
-
استخدام robots.txt: وكيل المستخدم الذي يجب تحديده في ملف robots.txt هو
APIs-Google. ولا يتّبع APIs-Google قواعد وكيل مستخدم Googlebot.
قد يحدث تأخير بسيط قبل أن يكتشف APIs-Google التغيير الذي تم إجراؤه على ملف robots.txt. إذا
استمر APIs-Google في إرسال رسائل إلى موقعك الإلكتروني لعدة أيام بعد حظره في ملف
robots.txt، تأكّد من أنّ ملف robots.txt في المكان المناسب.
التحقُّق من البرنامج الذي يطلب الزحف
إذا كنت تشتبه في أنك تتلقّى طلبات مخادعة، يمكنك
التحقق من أنّ برنامج التتبّع الذي يصل إلى خادمك يرسل الطلبات من google.com.
ابحث في سجلّاتك عن أي عناوين IP تعرّف نفسها بصفتها
وكيل مستخدم APIs-Google. ويعرض بحث نظام أسماء النطاقات العكسي نطاق googlebot.com أو
google.com.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eAPIs-Google is a user agent utilized by Google APIs to deliver push notifications, allowing developers to receive updates without continuous server polling.\u003c/p\u003e\n"],["\u003cp\u003eAPIs-Google accesses websites using HTTPS POST requests for notifications, employing retries with exponential backoff for failed deliveries, leading to varied traffic patterns.\u003c/p\u003e\n"],["\u003cp\u003eWebsites must possess a valid SSL certificate to receive notifications and should be optimized for prompt responses to minimize unnecessary retry attempts by APIs-Google.\u003c/p\u003e\n"],["\u003cp\u003eTo prevent APIs-Google access, website owners can unregister for notifications or utilize robots.txt to block the user agent.\u003c/p\u003e\n"],["\u003cp\u003eSpoofed requests can be identified by verifying the caller's IP address through reverse DNS lookup to confirm association with googlebot.com or google.com.\u003c/p\u003e\n"]]],["APIs-Google is Google's user agent for push notifications, delivering messages via HTTPS POST requests. Developers must verify domain ownership to use this service. APIs-Google retries failed requests with exponential backoff and can create sporadic traffic. Sites need valid SSL certificates, and apps should respond quickly to avoid retries. To block APIs-Google, unregister notifications or use `APIs-Google` in robots.txt. Spoofed requests can be identified by verifying IP addresses against googlebot.com or google.com domains.\n"],null,["# APIs-Google User Agent | Google Search Central\n\nAPIs-Google user agent\n======================\n\n\nAPIs-Google is the user agent used by Google APIs to deliver push notification messages.\nApplication developers can request these notifications to avoid the need for continually\npolling Google's servers to find out if the resources they are interested in have changed.\nTo make sure nobody abuses this service, Google requires developers to prove that they own\nthe domain before allowing them to register a URL with a domain as the location where they\nwant to receive messages.\n\nHow APIs-Google accesses your site\n----------------------------------\n\n\nAPIs-Google sends each push notification using an HTTPS POST request. If the request fails due\nto an error condition that might be temporary, APIs-Google will resend the notification. If\nthe request still doesn't succeed, it will continue to retry---based on an exponential backoff\nschedule---up to a maximum of several days.\n\n\nThe rate at which APIs-Google accesses your site varies by how many push notification requests\nwere created for servers on your site, by how fast the monitored resources are getting\nupdated, and by the number of retries occurring. As a result, the APIs-Google traffic patterns\ncan be consistent in some scenarios, but in other scenarios the traffic can be sporadic or\nspiky.\n\nPrepare your site for APIs-Google\n---------------------------------\n\n\nAPIs-Google uses HTTPS to deliver push notifications, so it requires your site to have a valid\nSSL certificate. **Invalid** certificates include the following:\n\n- Self-signed certificates.\n- Certificates signed by an untrusted source.\n- Certificates that have been revoked.\n\n\nAvoid unnecessary retry requests by ensuring that your application is well-designed and\nresponds promptly to notification messages (within seconds).\n\nPrevent APIs-Google from calling your site\n------------------------------------------\n\n\nTo prevent APIs-Google from calling your site, do one of the following:\n\n- **Unregister for notifications.** If you administer a domain that has subdomains or URL subspaces that are owned or administered separately, one of the subdomain owners may have set up an application that uses push notifications. If you want to block APIs-Google, contact anyone who might have set up an application like this and ask them to disable it.\n- **Use robots.txt.** The user agent to specify in the robots.txt file is `APIs-Google` - `APIs-Google` does not follow rules for the Googlebot user agent. There may be a small delay before `APIs-Google` discovers your robots.txt file change. If `APIs-Google` continues to send messages to your site several days after you've blocked it in robots.txt, check that the robots.txt is in the correct location.\n\nVerify the caller\n-----------------\n\n\nIf you suspect that you are receiving spoofed requests, you can\n[verify that a bot accessing your server really is calling from google.com](/search/docs/crawling-indexing/verifying-googlebot).\nSearch your logs for any IP addresses identifying themselves as the\n`APIs-Google` user agent; a reverse DNS lookup shows the googlebot.com or\ngoogle.com domain."]]
