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

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

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

انواع حساب‌های کاربری CSS

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

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

انواع برچسب‌های CSS

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

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

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

عملکرد API محتوا و نقاط پایانی برای CSSها

رابط برنامه‌نویسی کاربردی محتوا (Content API) نقاط پایانی زیر را برای CSSها ارائه می‌دهد:

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

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

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

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

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

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

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

مثال: اعمال یک برچسب به حساب مرکز بازرگانان

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

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

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

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

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

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

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

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

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

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

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

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

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