கூகுள் பிசினஸ் ப்ரொஃபைல் எம்சிபி சர்வரை உருவாக்குதல்

சர்வர் எதை வெளிப்படுத்துகிறது

சர்வர் எம்சிபி விவரக்குறிப்பிலிருந்து (டிரான்ஸ்போர்ட்ஸ்) ஸ்ட்ரீமபிள் HTTP டிரான்ஸ்போர்ட்டைப் பயன்படுத்துகிறது, எனவே உள்ளூரில் நிறுவ அல்லது இயக்க எதுவும் இல்லை. அதன் கருவிகள் மூன்று வகுப்புகளில் விழுகின்றன, மற்றும் ஒவ்வொரு கருவி விவரக்குறிப்பின் குறிப்புகளைக் கொண்டுள்ளது, எனவே ஒரு கிளையன்ட் ஒரு கருவி படிக்கிறதா, ரீச்சின் சொந்த தரவை மாற்றுகிறதா அல்லது ஒரு பொது கூகுள் பட்டியலை மாற்றுகிறதா என்பதை அழைப்பதற்கு முன் அறியும் (கருவி குறிப்புகள்).

சர்வர் எம்சிபி ப்ராம்ப்ட்களையும் வழங்குகிறது, விவரக்குறிப்பின் மீண்டும் பயன்படுத்தக்கூடிய தொடக்க வழிமுறைகள் (ப்ராம்ப்ட்கள்): ஒன்று ஒரு சுயவிவரத்தை ஒரு நேரத்தில் ஒரு உறுதிப்படுத்தப்பட்ட மாற்றத்துடன் மேம்படுத்துகிறது, ஒன்று தேடல் தெரிவுநிலையை மதிப்பாய்வு செய்கிறது, மற்றும் ஒன்று பதிலளிக்கப்படாத மதிப்பாய்வுகள் மூலம் வேலை செய்கிறது. ஒரு கிளையன்ட் அவற்றை தயாரான கோரிக்கைகளாக காட்டுகிறது.

ஒவ்வொரு கருவி ரீச் டாஷ்போர்டு அழைக்கும் அதே சர்வர் நடைமுறைகளை அழைக்கிறது, ஒரு உள்-செயல்முறை அழைப்பாளர் மூலம். இருப்பிட அணுகல் சரிபார்ப்புகள், திட்ட வரம்புகள் மற்றும் கூகுள் இணைப்பு சரிபார்ப்புகள் எனவே உள்நுழைந்த உரிமையாளருக்கு செய்வது போலவே இயங்குகின்றன; எம்சிபி அடுக்குக்கு அவற்றைச் சுற்றி எந்த பாதையும் இல்லை.

ஒரு உதாரண அமர்வு, அழைப்பு மூலம் அழைப்பு

ஒரு மாற்றம் கூகுளை எவ்வாறு அடைகிறது

ஒரு பொது பட்டியலில் மாற்றம் உரிமையாளரை இரண்டு முறை கடந்து செல்கிறது. முதலில், எழுது கருவிகள் destructiveHint ஐ எடுத்துச் செல்கின்றன, இது கிளையண்ட் தனது சொந்த ஒப்புதல் வரியைக் காட்ட அனுமதிக்கிறது. இரண்டாவதாக, ஒவ்வொரு கருவி விளக்கமும் மாதிரியிடம் சரியான மாற்றத்தைக் காட்டி உரையாடலில் வெளிப்படையான ஆம் பெற சொல்கிறது. சுயவிவரத் திருத்தங்கள் மற்றும் ஊடக மாற்றங்கள் மேலும் சென்று எதையும் எழுதாத முன்னோட்டத்திற்கு இயல்பாக அமைகின்றன.

ஒரு சுயவிவரத் திருத்தம் இரண்டு அழைப்புகளை எடுக்கிறது. முதலாவது, preview: true (இயல்பு) உடன், ஒவ்வொரு மாற்றப்பட்ட புலத்தின் முன் மற்றும் பின், நிராகரிக்கப்படும் எந்த புலமும் அதற்குத் தேவையான திருத்தத்துடன், மற்றும் அது படித்த சுயவிவரத்தின் basedOn கைரேகையைத் திருப்பித் தருகிறது. இரண்டாவது அழைப்பு அந்த கைரேகையை எடுத்துச் சென்று சுயவிவரம் அதற்குப் பின் மாறவில்லை என்றால் மட்டுமே எழுதுகிறது. இதற்கிடையில் யாரேனும் பட்டியலைத் திருத்தினால், டாஷ்போர்டில் அல்லது கூகுள் ஒத்திசைவு மூலம், எழுதுதல் மறுக்கப்படுகிறது மற்றும் உதவியாளர் மீண்டும் முன்னோட்டம் செய்ய வேண்டும்.

கூகுளின் சொந்த API புதுப்பிப்பு முகமூடியின் (locations.patch) கீழ் அனுப்பப்பட்ட புலங்களைப் பயன்படுத்துகிறது. ஒரு நபர் மாற்றத்தைப் பார்த்தாரா என்பதை அதனால் தெரியாது. முன்னோட்டம் மற்றும் கைரேகை அந்த சரிபார்ப்பை அதன் முன் வைக்கின்றன, எனவே ஒரு மாதிரி காலாவதியான அல்லது பார்க்கப்படாத திருத்தத்தைப் பயன்படுத்த முடியாது, மீண்டும் முயற்சித்தாலும் கூட.

இடுகைகள் மற்றும் மதிப்புரை பதில்களுக்கு முன்னோட்டப் படி இல்லை, ஏனெனில் உரிமையாளர் அங்கீகரிக்கும் உரையே மாற்றம்தான். அவற்றின் விளக்கங்கள் உதவியாளர் முதலில் சரியான இடுகை அல்லது பதிலைக் காட்ட வேண்டும். இடுகை செய்யப்பட்ட பதில் முந்தைய எந்த பதிலையும் மாற்றுகிறது மற்றும் எந்த கருவியும் அதை நீக்காது (reviews.updateReply), மற்றும் விளக்கம் அதைச் சொல்கிறது, எனவே மாதிரி ஒப்புக்கொள்வதற்கு முன் உரிமையாளரிடம் சொல்ல முடியும்.

ரீச் உரையாடலில் உறுதிப்படுத்தலைத் தேர்ந்தெடுத்தது, ரீச்சிற்குள் ஒரு முன்மொழி-மற்றும்-அங்கீகரி வரிசைக்கு பதிலாக. உரிமையாளர் ஏற்கனவே அரட்டையில் இருக்கிறார், இரண்டாவது இன்பாக்ஸ் புறக்கணிக்க எளிதான ஒரு படியைச் சேர்க்கிறது, மற்றும் எம்சிபி விவரக்குறிப்பு ஏற்கனவே ஒரு கருவி அழைப்பை மறுக்கக்கூடிய ஒரு மனிதனை எதிர்பார்க்கிறது (பாதுகாப்பு பரிசீலனைகள்).

மாதிரியைச் சார்ந்திருக்காத பாதுகாப்புகள்

விவரக்குறிப்பு கிளையண்டுகள் கருவி குறிப்புகளை நம்பத்தகாதவையாகக் கருத வேண்டும் என்று சொல்கிறது, அவை நம்பத்தகுந்த சர்வரில் இருந்து வராவிட்டால் (கருவி குறிப்புகள்), மற்றும் ஒரு மாதிரி ஒரு விளக்கத்தைப் புறக்கணிக்க முடியும். எனவே சர்வர் தனது சொந்த விதிகளை அமல்படுத்துகிறது:

• ஒரு கூகுள் எழுது பட்ஜெட். ஒவ்வொரு வணிகமும் உதவியாளர்கள் மூலம் ஒரு மணி நேரத்திற்கு 20 கூகுள் மாற்றங்கள் வரை செய்ய முடியும். ஒரு வளையத்தில் சிக்கிய மாதிரி வரம்பை அடைந்து எவ்வளவு நேரம் காத்திருக்க வேண்டும் என்று சொல்லப்படுகிறது, மீண்டும் மீண்டும் ஒரு சுயவிவரத்தை மீண்டும் எழுதுவதற்கு பதிலாக.
• மீண்டும் முயற்சி பாதுகாப்பு. ஒவ்வொரு மாற்றமும் ஒரு idempotency விசையை ஏற்றுக்கொள்கிறது. அதே விசையுடன் மீண்டும் செய்வது மீண்டும் எழுதுவதற்கு பதிலாக முதல் முடிவைத் திருப்பித் தருகிறது; விசை இல்லாமல், ஒரு குறுகிய சாளரத்திற்குள் ஒரே மாதிரியான அழைப்பு அதே மாற்றமாகக் கணக்கிடப்படுகிறது.
• ஒவ்வொரு அழைப்பிலும் இருப்பிட சரிபார்ப்பு. ஒரு மாதிரி அனுப்பும் இருப்பிட ஐடி ஒவ்வொரு முறையும் உரிமையாளரின் நேரடி கூகுள் அணுகலுக்கு எதிராக சரிபார்க்கப்படுகிறது, டாஷ்போர்டு பயன்படுத்தும் அதே சரிபார்ப்புடன். சர்வர் மாதிரி மீண்டும் பயன்படுத்த எந்த அமர்வையும் வைத்திருக்காது.
• மறைக்கப்பட்ட தொலைபேசி எண்கள். லீட்கள் மற்றும் புக்கிங் கோரிக்கைகள் தொலைபேசி எண்களை கடந்த நான்கு இலக்கங்களுக்கு மறைத்து திரும்பி வருகின்றன, குறிப்புகளுக்குள்ளும். மின்னஞ்சல்கள் கடந்து செல்கின்றன, ஏனெனில் ஒரு லீட்க்கு பதில் சொல்ல உரிமையாளருக்கு அவை தேவை.
• சர்வர் அமல்படுத்தும் திரும்பப் பெறுதல். ஒரு உரிமையாளர் ரீச்சில் உள்ள ஏஐ இணைப்பிகள் திரையில் இருந்து ஒரு உதவியாளரைத் துண்டிக்க முடியும், மற்றும் சர்வர் அந்த கிளையண்டின் டோக்கனை அப்போதிலிருந்து மறுக்கிறது.

மாதிரியிடம் அது என்ன பார்க்க முடியாது என்று சொல்வது

ஒரு வெற்று பட்டியலைப் பெறும் உதவியாளர் உரிமையாளரிடம் “உங்களுக்கு மதிப்புரைகள் இல்லை” என்று சொல்கிறார். பெரும்பாலும் உண்மை என்னவென்றால் தரவு உள்ளது ஆனால் மறைக்கப்பட்டுள்ளது: இருப்பிடம் அதன் பொது பட்டியலில் இருந்து சேர்க்கப்பட்டு கூகுள் இணைப்பு இல்லை, திட்டத்தில் ஒரு அம்சம் சேர்க்கப்படவில்லை, அல்லது கூகுள் முதல் ஒத்திசைவை முடிக்கவில்லை. எனவே படி முடிவுகள் காரணத்தையும் அதைச் சரிசெய்யும் இணைப்பையும் பெயரிடும் ஒரு வரம்புகள் பட்டியலை எடுத்துச் செல்கின்றன. ஒரு வெற்று பட்டியல் எதுவும் மறைக்கப்படவில்லை என்று அர்த்தம்.

கணக்கு முடிவு அம்சங்களுக்கும் அதையே செய்கிறது. ஒவ்வொன்றும் கிடைக்கக்கூடியதாக அல்லது இன்னும் கட்டப்படவில்லை எனக் குறிக்கப்படுகிறது, எனவே மாதிரி இன்று ரீச் செய்யக்கூடிய விஷயங்களாக அழைப்புகள் அல்லது விளம்பரங்களை விவரிக்காது. ஒரு உரிமையாளருக்கு ரீச்சில் இல்லாத ஒன்று தேவைப்படும்போது, உதவியாளர் உரிமையாளரின் வார்த்தைகளில் ரீச் குழுவிற்கு கோரிக்கையை அனுப்ப முடியும், அவர்களிடம் வார்த்தைகளைக் காட்டிய பின்.

ஒவ்வொரு பதிலும் கருவியின் ஸ்கீமா பதிப்பையும் திருப்பித் தருகிறது. கிளையண்டுகள் கருவி ஸ்கீமாக்களை கேச் செய்து ஒன்று மாறும்போது அமைதியாக தோல்வியடைய முடியும், எனவே ஒரு முறிவு மாற்றம் ஒரு கிளையண்டின் பிழை விகிதத்தில் மட்டுமல்லாமல் பதிலிலும் ரீச்சின் பதிவுகளிலும் தோன்றுகிறது.

உள்நுழைவு: OAuth 2.1, API கீகள் இல்லை

சர்வர் எம்சிபி அங்கீகார விவரக்குறிப்பு விவரிப்பது போல (அங்கீகாரம்) OAuth 2.1 பாதுகாக்கப்பட்ட வளமாகும். இது பாதுகாக்கப்பட்ட வள மெட்டாடேட்டாவை (RFC 9728) வெளியிடுகிறது, எனவே ஒரு கிளையண்ட் தானாகவே அங்கீகார சர்வரைக் கண்டுபிடித்து, தன்னைப் பதிவு செய்து ஒரு உலாவி உள்நுழைவைத் திறக்கிறது. உரிமையாளர் தங்கள் ரீச் கணக்கில் உள்நுழைகிறார்; ஒட்ட விசை எதுவும் இல்லை.

சர்வர் ஒவ்வொரு டோக்கன் இந்த வளத்திற்காக வழங்கப்பட்டதா மற்றும் அதே அங்கீகார சர்வரில் உள்ள மற்றொரு சேவைக்காக அல்ல என்பதைச் சரிபார்க்கிறது, வள குறிப்புகள் எதற்காக உள்ளனவோ அந்த குழப்பமான-டெபுட்டி பாதுகாப்பு (RFC 8707). கூகுள் இணைப்பு உதவியாளரை ஒருபோதும் அடையாது: ரீச் அதை வைத்திருக்கிறது, மற்றும் உதவியாளர் ஒருபோதும் ஒரு ரீச் டோக்கனை மட்டுமே வைத்திருக்கிறார்.

அதனால்தான் ஒரு உரிமையாளருக்கு கூகுள் API அணுகல் தேவையில்லை. கூகுள் பிசினஸ் ப்ரொஃபைல் API களை ஒரு அணுகல் கோரிக்கைக்குப் பின் ஒரு திட்டத்திற்கு வழங்குகிறது (முன்நிபந்தனைகள்), இதை பெரும்பாலான சிறு வணிகங்கள் ஒருபோதும் தாக்கல் செய்வதில்லை.

இது என்ன செய்ய முடியாது

• இது முதன்மை வகை அல்லது முகவரியை மாற்ற முடியாது. அவை கூகுளின் சொந்த கருவிகளில் உரிமையாளரிடமே இருக்கும்.
• இது ஒரு இடுகையை நீக்கவோ அல்லது ஒரு மதிப்புரை பதிலை அகற்றவோ முடியாது. இடுகை செய்யப்பட்ட பதிலை மாற்ற முடியும், நீக்க முடியாது.
• இணைக்கப்பட்ட கூகுள் பிசினஸ் ப்ரொஃபைல் இல்லாமல் இது பொது பட்டியலை மட்டுமே படிக்க முடியும். அதன் பொது பட்டியலில் இருந்து சேர்க்கப்பட்ட இருப்பிடம் அந்த ஸ்னாப்ஷாட்டையும் இணைக்க ஒரு இணைப்பையும் பெறுகிறது.
• இது உதவியாளர்கள் மூலம் ஒரு வணிகத்திற்கு ஒரு மணி நேரத்திற்கு 20 கூகுள் மாற்றங்களுக்கு மேல் செய்ய முடியாது.
• தேடல் தரவரிசை கண்காணிக்கப்பட்ட கீவேர்டுகளை மட்டுமே உள்ளடக்குகிறது. ஒரு புதிய கீவேர்டுக்கு அதன் முதல் சரிபார்ப்பு இயங்கும் வரை தரவரிசை இல்லை.

க்ளாட், சாட்ஜிபிடி அல்லது Cursor இல் இணைக்கவும்

சர்வர் URL

ரீச் கூகுள் பிசினஸ் ப்ரொஃபைல் எம்சிபி சேவையகம் பற்றி

ஒவ்வொரு கிளையண்ட் ரிமோட் சர்வர்களை வித்தியாசமாகச் சேர்க்கிறது, எனவே படிகள் ஒரு கிளையண்டிற்கு ஒரு பக்கத்தில் வாழ்கின்றன: க்ளாட், சாட்ஜிபிடி, க்ளாட் Code, Cursor மற்றும் VS Code. விற்பனையாளர்கள் அதே தரையை ஆவணப்படுத்துகிறார்கள்: Anthropic தனிப்பயன் இணைப்பிகள், OpenAI சாட்ஜிபிடி இலிருந்து இணைத்தல் மற்றும் Cursor எம்சிபி சர்வர்கள் பற்றி.

அடிக்கடி கேட்கப்படும் கேள்விகள்

இந்த எம்சிபி சர்வரைப் பயன்படுத்த எனக்கு கூகுள் பிசினஸ் ப்ரொஃபைல் API அணுகல் தேவையா?

இல்லை. ரீச் கூகுள் இணைப்பை வைத்திருக்கிறது, மற்றும் உதவியாளர் OAuth உடன் ரீச்சில் உள்நுழைகிறார். கூகுளின் API களுக்கு அங்கீகரிக்கப்பட்ட கூகுள் கிளவுட் திட்டம் தேவை (முன்நிபந்தனைகள்), இதை இது தவிர்க்கிறது.

எந்த ஏஐ உதவியாளர்கள் இதனுடன் வேலை செய்கின்றன?

க்ளாட், சாட்ஜிபிடி, க்ளாட் Code, Cursor, VS Code, Codex, Windsurf மற்றும் Cline உள்ளிட்ட OAuth உள்நுழைவுடன் கூடிய ரிமோட் எம்சிபி சர்வர்களை ஆதரிக்கும் எந்த கிளையண்டும்.

உதவியாளர் எனது பட்டியலைக் கேட்காமல் மாற்ற முடியுமா?

கூகுளுக்கான மாற்றங்கள் கிளையண்டின் ஒப்புதல் வரி மற்றும் உரையாடலில் ஒரு வெளிப்படையான ஆம் வழியாக செல்கின்றன, மற்றும் சுயவிவரத் திருத்தங்களுக்கு புதிய முன்னோட்டம் தேவை. சர்வர் உரையாடலைப் பார்க்க முடியாது, எனவே அது தானே அமல்படுத்தும் பாதுகாப்புகள் காலாவதியான-முன்னோட்ட மறுப்பு, மணி நேர கூகுள் எழுது வரம்பு மற்றும் மீண்டும் முயற்சி பாதுகாப்பு.

இதற்கு ஏதாவது செலவாகுமா?

படித்தல் இலவசம். ஒரு மதிப்புரை பதிலை வரைதல் ரீச் கிரெடிட்டுகளைப் பயன்படுத்துகிறது, மற்றும் சில அம்சங்கள் திட்டத்தைப் பொறுத்தது. இலவச திட்டம் ஒரு இருப்பிடத்தை உள்ளடக்குகிறது.

கூகுள் இணைப்பு உடைந்தால் என்ன நடக்கும்?

கணக்கு முடிவு ஒவ்வொரு இருப்பிடத்தின் இணைப்பு நிலையைக் காட்டுகிறது. அது செயலில் இல்லை என்றால், உதவியாளர் உரிமையாளரிடம் ரீச்சில் கூகுளை மீண்டும் இணைக்கச் சொல்கிறார் மற்றும் அந்த இருப்பிடத்தில் வேலை செய்வதை நிறுத்துகிறார்.

உங்கள் சொந்த சுயவிவரத்துடன் ஒரு உதவியாளரை இணைக்கவும்

படிக்க மட்டும் கேள்வியுடன் தொடங்குங்கள், எடுத்துக்காட்டாக எந்த மதிப்பீடுகளுக்கு பதில் இல்லை என்பது, பின்னர் ஒரு சிறிய மாற்றத்தை அனுமதித்து அதை மீண்டும் படியுங்கள். அமைவு பக்கம் ஒவ்வொரு கிளையண்டையும் விளக்குகிறது.

கூகுள் பிசினஸ் ப்ரொஃபைல் எம்சிபி சர்வரை அமைக்கவும்

ரீச்சில் ஏஐ இணைப்புகளைத் திறக்கவும்