این سند برخی از بهترین شیوه‌های استفاده از CSS API را شرح می‌دهد. توصیه های ارائه شده در این صفحه برای استفاده از API اجباری نیست، اما ممکن است به روشن شدن برخی از کاربردهای مورد نظر کمک کند.
محیط خود را تنظیم کنید
برای راه‌اندازی محیط توسعه خود، مراحل داده‌شده در اسناد شروع سریع را دنبال کنید.
- یک کاربر و یک فایل JSON مجوزها در Google Cloud Console ایجاد کنید
- CSS API را در Google Cloud Console فعال کنید
- آن کاربر با مجوزهای Admin را به حساب CSS خود (گروه یا دامنه) اضافه کنید
کتابخانه های مشتری اکنون در مخازن استاندارد اکثر زبان های برنامه نویسی قرار دارند. می توانید لیستی از آنها را در صفحه کتابخانه مشتری ما پیدا کنید.
روش های خوب برای شروع
ما آزمایش را با روش های زیر توصیه می کنیم:
ListChildAccounts
ListChildAccounts یک تماس فقط خواندنی است که همه دامنه‌های CSS شما (در صورت فراخوانی برای یک گروه CSS) یا بازرگانان شما (اگر برای یک دامنه CSS فراخوانی شده‌اند) را فهرست می‌کند. بنابراین یک روش خوب برای آزمایش اینکه آیا همه چیز به درستی تنظیم شده است یا خیر.
درج / لیست / به روز رسانی / حذف یک محصول
هنگامی که متوجه شدید که خود API کار می کند، سعی کنید محصولی را اضافه کنید. مطمئن شوید که از یک raw_provided_id استفاده می کنید که به خاطر دارید.
- یک محصول آزمایشی را با استفاده از InsertCssProductInput وارد کنید. اگر به کمک نیاز دارید که کدام ویژگی ها را ارسال کنید، کد نمونه داریم.
- همه محصولات خود را با استفاده از ListCssProducts فهرست کنید. قبل از نمایش محصول پس از قرار دادن، تاخیر کمی در پردازش وجود دارد، بنابراین اگر آن را مشاهده نکردید، پس از چند ثانیه دوباره امتحان کنید.
- یک محصول را با استفاده از UpdateCssProductInput با استفاده از
cssproductinput.nameخود به روز کنید. شما باید فقط ویژگی های مورد نیاز برای به روز رسانی را ارسال کنید. به نمونه کد اینجا مراجعه کنید. - محصول آزمایشی را با استفاده از DeleteCssProductInput حذف کنید. شما باید از
raw_provided_idاستفاده کنید.
از Async برای بهبود عملکرد استفاده کنید
CSS API برای تماس های موازی طراحی شده است. متوجه خواهید شد که عملکرد یک عملیات می تواند کند باشد، اما زمانی که یک عملیات را چندین بار به صورت موازی فراخوانی کنید، بسیار سریعتر خواهد بود. بهترین راه برای استفاده از این ویژگی، استفاده از قابلیت همگام زبان برنامه نویسی خود است.
نمونه هایی از برخی از زبان های برنامه نویسی:
- برای جاوا، از insertCssProductInputCallable().futureCall() استفاده کنید
- برای پایتون، از CssProductInputsServiceAsyncClient استفاده کنید
- برای C#، از InsertCssProductInputAsync استفاده کنید
قابلیت Async زبان برنامه نویسی خود را پیدا کنید و از آن برای درج چندین محصول به طور همزمان استفاده کنید. لازم نیست نگران بارگذاری بیش از حد سیستم‌های ما باشید - محدودیت‌های سهمیه برای این کار است.
جزئیات بیشتر را می توانید در صفحه عملکرد ما پیدا کنید.
یک محصول را به روز کنید
هنگامی که یک محصول آپلود شد، تا زمانی که به روز شود، حذف شود یا منقضی شود، در سیستم ما می ماند.
- می توانید با ارسال مجدد درخواست
InsertCssProductInput، با استفاده از همانraw_provided_idکه در ابتدا استفاده می کردید، محصول کامل را به روز کنید. در حال حاضر، باید اطلاعات کامل محصول را ارسال کنید، حتی اگر فقط برخی از ویژگی ها (شاید فقط قیمت/در دسترس بودن) تغییر کرده باشند. - می‌توانید بخش‌هایی از یک محصول را با استفاده از روش PATCH
UpdateCssProductInput، با مشخص کردن نام محصول و بدنه JSON حاوی داده‌هایی که می‌خواهید برای محصول به‌روزرسانی کنید، به‌روزرسانی کنید. برخلافInsertCssProductInput، که نیاز به ارائه تمام فیلدهای قابل اجرا دارد،UpdateCssProductInputفقط از شما می خواهد که فیلدهایی را که می خواهید تغییر دهید مشخص کنید. - می‌توانید با تماس با
DeleteCssProductInputبا همانraw_provided_idیک محصول را حذف کنید. - محصولات تقریباً یک ماه پس از آخرین به روز رسانی به طور خودکار منقضی می شوند.
حالت کار مداوم
یک حالت کار مداوم می تواند به شکل زیر باشد:
- از شناسه های داخلی خود به عنوان
raw_provided_idاستفاده کنید. - همه محصولات را در یک برنامه منظم، شاید به صورت هفتگی، دوباره آپلود کنید. این تضمین می کند که محصولات فعال منقضی نمی شوند.
- به محض دریافت داده های تغییر یافته از بازرگانان خود، تک تک محصولات را به روز کنید.
- اگر نمی‌توانید فوراً به تغییرات واکنش نشان دهید، همه محصولات تغییر یافته را مرتباً (شاید ساعتی) پیدا کنید و فقط آن محصولات را دوباره آپلود کنید.
- برای محصولاتی که دیگر در دسترس نیستند، می‌توانید از حذف تماس استفاده کنید یا تعداد پیشنهادات موجود را روی 0 تنظیم کنید.
- محصولات بدون تغییر را مرتبا برای ما ارسال نکنید. این تماس‌ها جزو سهمیه API شما محسوب می‌شوند. یک تجدید هفتگی کافی است.
انتخاب پیشنهاد سرفصل
پیشنهاد سرفصل لزوماً نباید بهترین پیشنهاد یا ارزان ترین پیشنهاد در سایت شما باشد، اما باید به طور برجسته نشان داده شود. می توانید از این برای مواردی استفاده کنید که پیشنهاد برتر شما به سرعت در حال تغییر است: در اینجا می توانید پیشنهاد دیگری را انتخاب کنید که پایدارتر باشد.
هر چند وقت یکبار این سند را دوباره بررسی کنید
ما بازخوردهایی در مورد چگونگی بهبود این API دریافت کرده‌ایم و در حال کار روی ارائه برخی از این بهبودها هستیم. این صفحه زمانی به روز می شود که ویژگی های جدیدی در دسترس داشته باشیم که استفاده از CSS API را ساده می کند.