با CSS API شروع کنید

در اینجا نحوه استفاده از CSS API آورده شده است:

مجوزها

یک حساب سرویس در کنسول Google API مشابه دستورالعمل های مربوط به Content API ایجاد کنید و یک فایل JSON را با اعتبارنامه دانلود کنید.

اگر می‌خواهید به سند سرویس دسترسی داشته باشید (فقط برای دسترسی مستقیم REST یا کتابخانه‌های Google API Client مورد نیاز است)، همچنین باید یک کلید API ایجاد کرده و از آن استفاده کنید. می توانید این کار را در کنسول API Google انجام دهید. می توانید اطلاعات بیشتری را در مستندات کلی درباره کلیدهای API بیابید.

آدرس ایمیل آن حساب سرویس باید با مجوزهای دسترسی Admin به گروه CSS یا حساب دامنه شما اضافه شود. انتشار این مجوزها می تواند نیم ساعت طول بکشد، بنابراین در صورت دریافت خطاهای رد شده، کمی دیرتر دوباره امتحان کنید.

CSS API را فعال کنید

برای استفاده از CSS API، باید آن را در پروژه ابری گوگل خود فعال کنید. می‌توانید کتابخانه را در 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 وجود دارد:

gRPC (توصیه می شود) استراحت
  1. بدنه درخواست را به عنوان بافر پروتکل ایجاد کنید.
  2. متن درخواست را با HTTP/2 به سرور ارسال کنید.
  3. پاسخ به یک بافر پروتکل را غیراصولی کنید.
  4. نتایج را تفسیر کنید.
  1. بدنه درخواست را به عنوان یک شی JSON ایجاد کنید.
  2. آن را با استفاده از HTTP 1.1 به سرور ارسال کنید.
  3. پاسخ را به‌عنوان یک شی JSON از حالت سریال خارج کنید.
  4. نتایج را تفسیر کنید.

کمک بگیرید

برای پشتیبانی با نماینده Google خود تماس بگیرید یا از فرم بازخورد برای گزارش هرگونه مشکل استفاده کنید.

در اینجا نحوه ارائه بازخورد بیشتر در صورت بروز مشکلات آمده است:

بازخورد بدهید

برای ارائه بازخورد، یکی از موارد زیر را ارسال کنید:

  • ویژگی های API: فرم بازخورد را ارسال کنید
  • مستندات: از رتبه‌بندی انگشت شست درون صفحه و دکمه ارسال بازخورد استفاده کنید.
  • نمونه ها و کتابخانه ها: از دکمه شماره جدید در Github استفاده کنید.

برای ارائه بازخورد کلی پس از اجرای هر کار، از فرم بازخورد استفاده کنید.

قبلی
نمای کلی
بعدی
بهترین شیوه ها