بدء استخدام CSS API

في ما يلي كيفية استخدام واجهة CSS API:

الأذونات

أنشئ حساب خدمة في وحدة تحكم واجهة برمجة تطبيقات Google المشابهة الـ تعليمات بشأن Content API وتنزيل ملف جسون يتضمن بيانات الاعتماد.

إذا كنت تريد الوصول إلى مستند الخدمة (مطلوب فقط للوصول المباشر إلى REST أو لمكتبات برامج عملاء Google API)، يجب أيضًا إنشاء تستخدم مفتاح واجهة برمجة التطبيقات. يمكنك إجراء ذلك في وحدة التحكم في واجهة Google API: يمكنك والعثور على مزيد من المعلومات في الوثائق العامة حول مفاتيح واجهة برمجة التطبيقات:

يجب إضافة عنوان البريد الإلكتروني لحساب الخدمة هذا ومنحه إذن الوصول الإداري. الأذونات الممنوحة لمجموعة CSS أو حساب النطاق يعد انتشار هذه يمكن أن تستغرق الأذونات نصف ساعة، لذا يمكنك إعادة المحاولة لاحقًا إذا حصلت على أخطاء رفض الإذن.

تفعيل واجهة CSS API

لاستخدام CSS API، يجب تفعيلها في Google Cloud. مشروعك. يمكنك العثور على المكتبة على https://console.cloud.google.com/apis/library/css.googleapis.com.

بدء البرمجة

تشمل واجهة CSS API عيّنات تعليمات برمجية ومكتبات البرامج سيساعدك على البدء. لدينا أيضًا أفضل الممارسات.

إرسال الطلبات

إرسال الطلبات إلى عناوين URL بالتنسيق التالي:

https://css.googleapis.com/{version}/{resource name}:{method}…

حيث يكون {resource name} هو اسم المورد تأثير مكالمتك.

على سبيل المثال، إليك كيفية حذف مورد باستخدام gRPC:

https://css.googleapis.com/v1/{resource name}:delete

إليك كيفية حذف مورد باستخدام REST:

DELETE https://css.googleapis.com/v1/{resource name}

الاطّلاع على واجهة CSS API المستندات المرجعية للحصول على مزيد من التفاصيل حول خدمات معيّنة.

استخدام gRPC أو REST

تتيح واجهة CSS API استخدام gRPC REST إليك طريقتين لإجراء طلبات البيانات من واجهة برمجة تطبيقات CSS:

gRPC (يُنصح به) راحة
  1. إنشاء نص الطلب كمخزن مؤقت للبروتوكول
  2. أرسِل نص الطلب إلى الخادم باستخدام HTTP/2.
  3. إلغاء تكرار الاستجابة للمخزن المؤقت للبروتوكولات.
  4. تفسير النتائج.
  1. إنشاء نص الطلب ككائن JSON.
  2. أرسله إلى الخادم باستخدام HTTP 1.1.
  3. إلغاء ترتيب الاستجابة ككائن JSON.
  4. تفسير النتائج.

الحصول على مساعدة

يُرجى التواصل مع ممثل عن Google للحصول على الدعم أو استخدام نموذج الملاحظات للإبلاغ عن أي المشكلات.

إليك كيفية تقديم المزيد من الملاحظات في حال مواجهة مشاكل:

تقديم التعليقات

لإرسال الملاحظات، أرسِل أحد الخيارات التالية:

  • ميزات واجهة برمجة التطبيقات: أرسِل نموذج الملاحظات.
  • المستندات: استخدام التقييمات بالإصبع في الصفحة وإرسال التعليقات .
  • عيّنات ومكتبات: استخدِم زر مشكلة جديدة على GitHub.

لتقديم ملاحظات عامة بعد تنفيذ كل مهمة، استخدم الملاحظات النموذج.

السابق
نظرة عامة
التالي
أفضل الممارسات