Google Ads बदलाव प्राप्त करना /google-ads/v1/changes/{change_id} पर एक GET है, जो Top-Rated Team Google Ads API में आता है: आपके संगठन को दिए गए Google Ads अकाउंट। हर रिक्वेस्ट आपकी अपनी key को X-API-KEY हेडर में लेकर चलती है — वही key जो LinkedIn API की है — और सिर्फ़ उन्हीं अकाउंट तक पहुँचती है जो आपके संगठन को सौंपे गए हैं। जो अकाउंट उसे किसी ने नहीं सौंपा, उसका जवाब ऐसे आता है जैसे वह है ही नहीं।
यहाँ कुछ भी अपने आप किसी अकाउंट को नहीं बदलता। बदलाव प्रस्तावित किया जाता है, Google उसे जाँचता है और वह दर्ज किया जाता है, और वह तब चलता है जब कोई व्यक्ति उसे लागू करे — और उसे पलटने में जो लगेगा वह पहले दर्ज कर लिया जाता है, ताकि सब कुछ वापस रखा जा सके।
रिक्वेस्ट
curl -X GET "https://top-rated.team/google-ads/v1/changes/$CHANGE_ID" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
पाथ में क्या जाता है
- change_id — इसी परिवार की किसी पिछली कॉल से लौटी हुई id।
न चलने पर क्या लौटता है
- 401 — key नहीं है, ग़लत है या रद्द कर दी गई है।
- 402 — प्लान का भुगतान नहीं हुआ। ट्रायल ख़त्म होने पर Top-Rated Team API योजना यही लौटाती है।
- 404 — या तो वह चीज़ है ही नहीं, या वह आपके संगठन की नहीं है। दोनों का जवाब जान-बूझकर एक ही है, ताकि id टटोली न जा सकें।
- 429 — बहुत ज़्यादा रिक्वेस्ट, या प्लेटफ़ॉर्म हमसे धीमे चलने को कह रहा है। दोबारा कोशिश करने से पहले थोड़ा इंतज़ार कीजिए।
- 502 या 503 — प्लेटफ़ॉर्म ने अभी जवाब नहीं दिया। थोड़ी देर में फिर कोशिश कीजिए।
हर एरर एक ही शक्ल का JSON है: {"type":"errors/<code>","status":<n>,"detail":"..."} — इसलिए एक ही हैंडलर सब संभाल लेता है, और detail इसी तरह लिखा गया है कि किसी इंसान को दिखाया जा सके।
इसके बजाय असिस्टेंट से कहिए
यह ऑपरेशन एक MCP टूल भी है। https://top-rated.team/google-ads/mcp/<your API key> को Claude, ChatGPT या किसी भी MCP बोलने वाले असिस्टेंट में चिपकाइए और आम भाषा में जो चाहिए वह माँगिए — असिस्टेंट ख़ुद कॉल चुनेगा, id भरेगा और जवाब पढ़कर सुनाएगा। https://top-rated.team/mcp/<your API key> वाले ऑल-इन-वन एजेंट के पास भी यह है, LinkedIn API और बाकी हर चैनल के साथ।
प्रोजेक्ट रूम में
प्रोजेक्ट रूम में अपने किसी AI एजेंट के लिए “इस्तेमाल कर सकता है” के नीचे इस API के एजेंट पर टिक कीजिए, और जब भी बातचीत को ज़रूरत हो, वह “Google Ads बदलाव प्राप्त करना” को टूल की तरह कॉल करता है। रूम में हर कोई देखता है कि उसने क्या माँगा और क्या लौटा। आम भाषा में कहिए; यहाँ एजेंट का नाम @scout है:
- @scout बताइए कि पिछले हफ़्ते हमारे सर्च टर्म में सबसे ज़्यादा पैसा किसने बर्बाद किया, और नेगेटिव कीवर्ड एक प्रस्ताव के रूप में लिखिए जिसे चलने से पहले कोई पढ़ ले।
अक्सर पूछे जाने वाले सवाल
क्या कोई AI एजेंट मेरे लिए “Google Ads बदलाव प्राप्त करना” कॉल कर सकता है?
हाँ। MCP बोलने वाला कोई भी असिस्टेंट ऊपर के पते के ज़रिए कर सकता है, और प्रोजेक्ट रूम में इस API के एजेंट पर टिक वाला आपका अपना AI एजेंट भी। रूम के बिल्ट-इन एजेंट नहीं कर सकते: वे सलाह देते हैं, और उनके पास आपकी key नहीं होती।
क्या यह रूम के बाहर, मेरे अपने कोड से चलता है?
हाँ। ऊपर की रिक्वेस्ट वही ऑपरेशन है जिसे AI एजेंट के टूल कॉल करते हैं, उसी जवाब और उन्हीं एरर के साथ, और आप जिस रास्ते से भी आएँ, आपकी key उन्हीं चैनलों तक पहुँचती है।
क्या यह मेरे अपने ब्रांड वाले रूम में चलता है?
हाँ। व्हाइट-लेबल पते पर API, उसकी संदर्भिका और उसका AI एजेंट आपके प्रोडक्ट के नाम से चलते हैं, और उन्हीं नियमों के तहत उन्हीं चैनलों तक पहुँचते हैं।
किस प्लान में है
Top-Rated Team API प्लान में शामिल, LinkedIn API वाली उसी key के साथ: $9 प्रति सीट प्रति माह, सौ सीट से $7। आपको उतनी सीट चाहिए जितनी इनमें से जिसकी संख्या सबसे ज़्यादा हो — LinkedIn अकाउंट, WhatsApp नंबर, X अकाउंट या इनबॉक्स अकाउंट — और 30 दिन का ट्रायल एक सीट को कवर करता है।