مدیریت برچسب CSS

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

برای اطلاعات بیشتر در مورد CSS ها، به مقایسه خدمات خرید مراجعه کنید. برای اطلاعات در مورد کار با برچسب‌ها در مرکز CSS، به استفاده از برچسب‌های حساب در مرکز خدمات خرید مقایسه مراجعه کنید.

انواع حساب های CSS

CSS ها از سه نوع حساب زیر استفاده می کنند:

  • گروه‌های CSS حساب‌های سطح بالایی هستند که می‌توانند شامل یک یا چند دامنه CSS باشند.
  • دامنه‌های CSS حساب‌هایی برای خود CSS‌ها هستند که تبلیغات خرید را از طرف تاجران درج می‌کنند. هر دامنه CSS فقط می تواند به یک گروه CSS تعلق داشته باشد.
  • حساب‌های Merchant Center بازرگانی هستند که دامنه‌های CSS برای آنها تبلیغات خرید قرار می‌دهند. CSS ها را می توان با چندین نوع مختلف از حساب های Merchant Center، از جمله حساب های چند مشتری (MCA) و حساب های تجاری فردی مرتبط کرد. هر حساب Merchant Center فقط می تواند با یک دامنه CSS مرتبط شود. برای اطلاعات بیشتر در مورد انواع حساب‌های Merchant Center، انواع حساب‌ها را در Comparison Shopping Service Center ببینید.

انواع برچسب CSS

CSS ها از دو نوع برچسب استفاده می کنند:

  • برچسب‌های دستی توسط دامنه‌های CSS به حساب‌های Merchant Center و توسط گروه‌های CSS به دامنه‌های CSS اختصاص داده می‌شوند.
  • برچسب‌های خودکار به‌طور خودکار توسط مرکز CSS ایجاد و به حساب‌های Merchant Center اختصاص داده می‌شوند. برچسب‌های خودکار برای انواع مختلف معیارهای حساب در دسترس هستند و می‌توانند به شما در شناسایی حساب‌های مهم و فعالیت‌های مهم حساب کمک کنند.

برای اطلاعات بیشتر در مورد انواع برچسب، از جمله برچسب‌های خودکار موجود، به استفاده از برچسب‌های حساب در مرکز خدمات خرید مقایسه مراجعه کنید.

قابلیت Content API و نقاط پایانی برای CSS

Content API نقاط پایانی زیر را برای CSS ها ارائه می دهد:

هنگام فراخوانی نقاط پایانی accounts به عنوان یک دامنه CSS، از شرایط زیر آگاه باشید:

  • دامنه های CSS باید cssId خود را به جای merchantId ارائه کنند.
  • دامنه های CSS باید یک پارامتر کوئری view=CSS ارائه دهند.
  • دامنه های CSS باید شناسه حساب Merchant Center مرتبط خود را به عنوان accountId ارائه دهند.

مثال: یک برچسب ایجاد کنید

برای ایجاد برچسب جدید می توانید از روش accounts.labels.create استفاده کنید. برچسب‌ها را می‌توان برای دامنه‌های CSS و حساب‌های Merchant Center اعمال کرد. با این حال، برچسب‌ها برای انواع مختلف حساب‌ها مجزا هستند و نمی‌توان آنها را به جای هم استفاده کرد. برای ایجاد یک برچسب در سطح دامنه، که می تواند برای حساب های Merchant Center مرتبط با دامنه اعمال شود، از شناسه دامنه CSS به عنوان accountId هنگام ایجاد برچسب استفاده کنید. برای ایجاد یک برچسب در سطح گروه، که می تواند برای دامنه های CSS وابسته به گروه اعمال شود، از شناسه گروه CSS به عنوان accountId هنگام ایجاد برچسب استفاده کنید.

مثال زیر نحوه ایجاد برچسب حساب‌های کلیدی در سطح دامنه را نشان می‌دهد که می‌توان آن را روی حساب‌های Merchant Center مرتبط با دامنه اعمال کرد. برای ایجاد برچسب، یک درخواست POST با استفاده از URL و بدنه درخواست زیر ایجاد کنید: 

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels

{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

مثال: برچسبی را به حساب Merchant Center اعمال کنید

می‌توانید از روش accounts.updatelabels برای اختصاص برچسب‌ها به حساب Merchant Center مرتبط با دامنه CSS استفاده کنید. مثال زیر نحوه اعمال برچسب حساب‌های کلیدی ایجاد شده در مثال قبلی را به یکی از مهم‌ترین حساب‌های Merchant Center نشان می‌دهد.

برای اعمال برچسب، با استفاده از URL و بدنه درخواست زیر، یک درخواست POST ایجاد کنید: 

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/

{
 "labelIds": [‘123’] // ‘key-accounts’
}

مثال: از برچسب‌ها برای فیلتر کردن حساب‌های Merchant Center استفاده کنید

پس از ایجاد و اعمال برچسب‌ها به حساب‌های Merchant Center مرتبط با یک دامنه CSS، می‌توانید از روش accounts.list استفاده کنید و پارامتر query label را در درخواست خود ارسال کنید تا فقط حساب‌های دارای آن برچسب را برگردانید. مثال زیر نحوه فیلتر کردن حساب‌های Merchant Center مرتبط با یک دامنه CSS را با استفاده از id ( 123 ) برچسب حساب‌های کلیدی ایجاد شده در مثال ایجاد برچسب نشان می‌دهد. برای بازیابی حساب‌ها، با استفاده از URL زیر درخواست GET کنید:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

هیچ بدنه درخواستی مورد نیاز نیست.

مثال: یک برچسب به دامنه CSS اعمال کنید

همچنین می‌توانید از روش csses.updatelabels برای اختصاص برچسب‌ها به یک دامنه CSS وابسته به یک گروه CSS استفاده کنید. مثال زیر نشان می دهد که چگونه می توان یک برچسب در سطح گروه دامنه های کلیدی ایجاد شده با استفاده از روش accounts.labels.create را در یکی از مهم ترین حساب های دامنه CSS خود اعمال کرد. به خاطر داشته باشید که برچسب‌ها برای دامنه‌های CSS و حساب‌های Merchant Center مجزا هستند. برچسب‌های سطح گروه باید با استفاده از شناسه گروه CSS به عنوان accountId ایجاد شوند.

برای اعمال برچسب، با استفاده از URL و بدنه درخواست زیر، یک درخواست POST ایجاد کنید: 

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}