منصوبے کے بارے میں

یہ ریپوزٹری گوگل APIs کے لیے خودکار طور پر تیار کردہ Go کلائنٹ لائبریریاں فراہم کرتی ہے، جو گوگل Discovery Service کی JSON تفصیلی فائلوں سے اخذ کی گئی ہیں۔ ہر API کو اپنے قابل درآمد پیکج کے طور پر پیش کیا گیا ہے، تاکہ آپ صرف وہی شامل کریں جس کی ضرورت ہو، مثال کے طور پر google.golang.org/api/tasks/v1 یا google.golang.org/api/urlshortener/v1، پھر NewService(ctx) کے ساتھ سروس تعمیر کریں۔ اہم خصوصیات: - تیار کردہ کوڈ: لائبریریاں Discovery دستاویزات سے ایک جنریٹر کے ذریعے تیار کی جاتی ہیں، اس لیے ریلیز کے درمیان بریکنگ تبدیلیاں آ سکتی ہیں؛ جنریٹر اور اس کا آؤٹ پٹ بیٹا تصور کیا جاتا ہے۔ - سپورٹ کی حیثیت: گوگل کی طرف سے سرکاری طور پر معاون، لیکن لائبریریوں کو مکمل اور مینٹیننس موڈ میں بیان کیا گیا ہے، یعنی اہم بگز اور سیکیورٹی مسائل حل کیے جاتے ہیں جبکہ نئی خصوصیات شامل نہیں کی جاتیں۔ - کلاؤڈ APIs: گوگل کلاؤڈ پلیٹ فارم سروسز جیسے Datastore یا Pub/Sub کے لیے، README صارفین کو اس کی بجائے علیحدہ Cloud Client Libraries for Go کی طرف رہنمائی کرتا ہے۔ اجازت نامہ: - ڈیفالٹ طور پر، سروسز گوگل Application Default Credentials استعمال کرتی ہیں، جس سے ایپلیکیشنز بغیر واضح ترتیب کے کئی ماحول میں چل سکتی ہیں۔ - JSON کلیدی فائلیں option.WithAuthCredentialsFile کے ذریعے واضح اسنادی قسم (مثلاً ServiceAccount) کے ساتھ فراہم کی جا سکتی ہیں، یا JSON اسناد براہ راست option.WithAuthCredentialsJSON کے ذریعے۔ - پرانے option.WithCredentialsFile اور option.WithCredentialsJSON فنکشنز ممکنہ سیکیورٹی خطرے کی وجہ سے فرسودہ کر دیے گئے ہیں۔ - مزید باریک کنٹرول کے لیے، golang.org/x/oauth2 سے oauth2.TokenSource کو option.WithTokenSource کے ساتھ پاس کیا جا سکتا ہے۔ دستاویزات اور مثالیں: - طویل ٹیوٹوریلز اور نمونہ استعمال کے لیے ایک Getting Started گائیڈ اور ایک examples ڈائریکٹری کا حوالہ دیا گیا ہے۔ - پیکج دستاویزات pkg.go.dev پر دستیاب ہیں، اور کمیونٹی سپورٹ کے لیے golang-nuts میلنگ لسٹ کی طرف رہنمائی کی گئی ہے۔ یہ ایک ڈویلپر کے لیے SDK مجموعہ ہے نہ کہ صارف کی ایپلیکیشن؛ اس کی قدر اس میں ہے کہ یہ Go پروگراموں کو مستقل تصدیقی طریقوں کے ساتھ گوگل APIs کی وسیع رینج تک ٹائپ شدہ رسائی فراہم کرتا ہے۔