APIs-Google은 푸시 알림 메시지를 전달하기 위해 Google API에서 사용하는 사용자 에이전트입니다.
이 알림을 요청하면 애플리케이션 개발자는 관심 있는 리소스가 변경되었는지 확인하기 위해 끊임없이 Google 서버를 폴링하지 않아도 됩니다.
Google에서는 이 서비스의 남용을 막기 위해 개발자가 메시지를 수신할 위치로 URL을 등록하기 전에 이 URL이 속한 도메인의 소유권을 증명하도록 하고 있습니다.
APIs-Google의 사이트 액세스 방법
APIs-Google에서는 HTTPS POST 요청을 사용하여 각 푸시 알림을 보냅니다. 일시적일 수 있는 오류 상태로 인해 요청에 실패하면 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 파일의 변경사항을 발견하기까지 시간이 약간 걸릴 수도 있습니다. robots.txt에서 차단한 후 며칠이 지나도 APIs-Google에서 사이트에 계속 메시지를 보낸다면 robots.txt가 올바른 위치에 있는지 확인하세요.
호출자 확인
스푸핑된 요청을 받고 있다고 의심되는 경우에는 서버에 액세스하는 크롤러가 실제로 google.com에서 호출하는 것인지 확인할 수 있습니다. 로그에서 APIs-Google 사용자 에이전트로 자신을 식별하는 IP 주소가 있는지 찾아봅니다. 역방향 DNS 조회 시 googlebot.com 또는 google.com 도메인이 표시됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-04(UTC)"],[[["\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\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\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\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\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\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."]]
