خدمات خرید مقایسه (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.labels
: به شما امکان میدهد برچسبهایی را ایجاد، بازیابی و اصلاح کنید تا به حسابهای دامنه CSS و Merchant Center اعمال شود. برای مثال، ایجاد برچسب را ببینید. -
accounts.updatelabels
: به شما امکان میدهد برچسبها را روی یک حساب Merchant Center اعمال کنید. برای مثال، اعمال برچسب برای حساب Merchant Center را ببینید. -
accounts.list
: به شما امکان میدهد تمام حسابهای Merchant Center مرتبط با یک دامنه CSS، از جمله برچسبهای اعمال شده برای هر حساب را بازیابی کنید. همچنین میتوانید برای بازیابی زیرمجموعهای از حسابهای مرتبط، بر اساسid
برچسب فیلتر کنید. برای مثال، استفاده از برچسبها برای فیلتر کردن حسابهای Merchant Center را ببینید. -
accounts.get
: به شما امکان میدهد برچسبهای اعمال شده روی یک حساب Merchant Center را بازیابی کنید. -
csses
: به شما امکان می دهد تا ارتباط بین برچسب ها و دامنه های CSS را مشاهده و مدیریت کنید. برای مثال، به اعمال برچسب در دامنه 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’
}