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

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

الأذونات

لاستخدام CSS API، عليك ضبط الأذونات في مكانَين: Google Cloud وCSS Center.

1. إدارة الهوية وإمكانية الوصول في Google Cloud:

   • أنشئ حساب خدمة في وحدة تحكّم Google Cloud. اتّبِع التعليمات نفسها المتّبعة مع Content API لإنشاء ملف بيانات اعتماد JSON وتنزيله. تتيح هذه الخطوة إثبات صحة حساب الخدمة ككيان صالح على Google Cloud.
   • إذا كنت تستخدم إذن الوصول المباشر إلى REST أو مكتبات Google API Client، ستحتاج أيضًا إلى مفتاح API تم إنشاؤه من Google Cloud Console.

2. CSS Center:

   • عنوان البريد الإلكتروني لحساب الخدمة (مثلاً your-service-account-name@your-project-id.iam.gserviceaccount.com) يجب إضافته كمستخدم لديه إذن وصول إداري إلى حسابك على CSS Center. تمنح هذه الخطوة حساب الخدمة الإذن بالوصول إلى بياناتك في CSS Center وإدارتها.
   • يمكنك منح الإذن بالوصول على مستوى مجموعة CSS (للوصول إلى جميع النطاقات) أو إلى حسابات نطاق CSS محدّدة. بالنسبة إلى الوصول إلى واجهة برمجة التطبيقات، من الشائع منح الإذن بالوصول على مستوى مجموعة CSS.
   • لإضافة حساب الخدمة، اتّبِع الخطوات التالية:
     • سجِّل الدخول إلى CSS Center باستخدام حساب مشرف.
     • انتقِل إلى الوصول إلى الحساب (ضمن رمز الترس ⚙️).
     • انقر على + إضافة مستخدم وأدخِل عنوان البريد الإلكتروني لحساب الخدمة.
     • اضبط مستوى الوصول على مشرف.
   • قد يستغرق نشر الأذونات مدة تصل إلى 30 دقيقة. إذا واجهت أخطاء متعلقة بالأذونات، يُرجى إعادة المحاولة لاحقًا.

نطاق المصادقة:

نطاق OAuth 2.0 المطلوب لواجهة CSS API هو:

• https://www.googleapis.com/auth/content

تأكَّد من أنّ تطبيقك يطلب هذا النطاق عند إجراء المصادقة.

تفعيل واجهة برمجة التطبيقات 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 API:

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

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

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

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

لتقديم ملاحظات، يُرجى إرسال أحد الخيارات التالية:

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

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