شروع به کار با خدمات مقایسه خرید (CSS)

انجام عملیات پایه با API راه خوبی برای شروع استفاده از آن است.

پیش نیازها

قبل از شروع، موارد زیر را کامل کنید:

  • مطمئن شوید که یک حساب معتبر CSS Center دارید.
  • یک توسعه دهنده API ثبت کنید.
  • صحت تنظیم مجوزهای خود را تأیید کنید.
  • بررسی کنید که CSS API را فعال کرده اید.
  • بررسی کنید که کتابخانه های سرویس گیرنده را برای محیط خود نصب کرده اید.

برای اطلاعات بیشتر، به شروع سریع مراجعه کنید.

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

برای استفاده از CSS API به عنوان یک توسعه دهنده ثبت نام کنید، باید حساب مرکز CSS و پروژه Google Cloud خود را با استفاده از روش ثبت توسعه دهنده به شرح زیر پیوند دهید:

پیوند مرکز CSS و پروژه Google Cloud شما: پیوند به طور خودکار ایجاد می شود، زیرا تماس گیرنده بر اساس نشانه Access یا کلید API به پروژه Google Cloud دسترسی دارد و کاربر مجاز حساب CSS Center است.

یک توسعه دهنده API ثبت کنید

افزودن یک کاربر توسعه‌دهنده API به حساب مرکز CSS: اگر کاربری از قبل وجود داشته باشد، نوع دسترسی جدید «توسعه‌دهنده API» به او اعطا می‌شود. در صورت وجود یک کاربر جدید، آنها یک دعوت نامه ایمیل CSS Center دریافت می کنند.

پس از ثبت نام، می توانید وضعیت ثبت نام را با استفاده از GetDeveloperRegistration مشاهده کنید یا با استفاده از UnregisterGCP ، ثبت نام را لغو کنید. می توانید از تماس ثبت نام زیر استفاده کنید:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

پس از اجرای موفقیت آمیز درخواست، منتظر پاسخ باشید:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

محصولات CSS

مشابه API فرعی Products ، CSS API بین CssProductInput و ListCssProduct تمایز قائل می شود. یک محصول را با InsertCssProductInput وارد کنید.

هنگامی که سیستم های داخلی ما محصول را پردازش کردند (این ممکن است چند دقیقه طول بکشد)، آن را با ListCssProducts بازیابی کنید.

محصولات خود را با استفاده از raw_provided_id شناسایی کنید. توصیه می کنیم از شناسه ای که قبلاً در سیستم خود استفاده می کنید استفاده کنید. متناوبا، روش‌های متداول برای ایجاد یکی شامل استفاده از یکی از موارد زیر است:

  • شناسه های منحصر به فرد جهانی (GUID)
  • شناسه های منحصر به فرد جهانی (UUID)
  • ویژگی های منحصر به فرد محصول به هم پیوسته (به عنوان مثال، نام تجاری_model_color_size)

برای اطلاعات بیشتر، درج/فهرست/به‌روزرسانی/حذف یک محصول را ببینید.

عملیات اساسی

در اینجا چند درخواست اساسی وجود دارد که می توانید امتحان کنید.

  1. یک محصول آزمایشی را با استفاده از InsertCssProductInput وارد کنید. برای راهنمایی در مورد ویژگی‌های ارسال، این کد نمونه را مرور کنید.

  2. همه محصولات خود را با استفاده از ListCssProducts فهرست کنید. توجه داشته باشید که تاخیر پردازش کمی بین درج یک محصول و ظاهر آن برای فهرست وجود دارد. اگر فوراً یکی را مشاهده نکردید، پس از چند ثانیه دوباره امتحان کنید.

  3. یک محصول را با استفاده از UpdateCssProductInput با استفاده از cssproductinput.name خود به روز کنید. شما باید فقط ویژگی های مورد نیاز برای به روز رسانی را ارسال کنید. برای مثال، کد نمونه را ببینید.

  4. محصول آزمایشی را با استفاده از DeleteCssProductInpu raw_provided_id ارائه می کند، حذف کنید.

محدودیت ها

درج یا حذف یک محصول جداگانه ممکن است کند باشد. برای بهبود عملکرد، از Async برای بهبود عملکرد استفاده کنید . این امکان فراخوانی موازی API را فراهم می کند.

حساب های خود را فهرست و برچسب بزنید

مدیریت برچسب در CSS API به شما امکان می‌دهد تا حساب‌های Merchant Center مشتری خود را با استفاده از برچسب‌های سفارشی سازماندهی کنید. این ویژگی به شما کمک می کند تا مشتریان را به طور موثر دسته بندی کنید (به عنوان مثال، بر اساس نوع یا استراتژی)، سازماندهی بهتر و عملیات ساده تر را ممکن می سازد. می توانید از API برای انجام عملکردهای زیر روی برچسب ها استفاده کنید: