CSS etiket yönetimi

Karşılaştırmalı Alışveriş Hizmetleri (CSS'ler), CSS programının kullanıma sunulduğu ülkelerde satıcılar adına Google'da Alışveriş reklamları yayınlayabilir. Content API, CSS alanlarının ve CSS gruplarının, ilişkilendirilmiş hesaplarını etiketleri kullanarak düzenlemesine olanak tanır. CSS alanları, alanla ilişkili Merchant Center hesaplarını listeleyebilir, etiketleyebilir ve filtreleyebilir. CSS grupları, grupla ilişkili CSS alanlarını etiketleyip listeleyebilir. Bu Content API hizmetleri, Comparison Shopping Service Center'da bulunan bazı özelliklerin programatik eşdeğerleri sağlar.

CSS'ler hakkında daha fazla bilgi için Karşılaştırmalı Alışveriş Hizmetleri bölümüne bakın. CSS Center'da etiketlerle çalışma hakkında bilgi için Comparison Shopping Service Center'da hesap etiketlerini kullanma bölümüne bakın.

CSS hesap türleri

CSS'ler aşağıdaki üç hesap türünü kullanır:

  • CSS grupları, bir veya daha fazla CSS alanı içerebilen üst düzey hesaplardır.
  • CSS alanları, satıcılar adına Alışveriş reklamları yerleştiren CSS'lere ait hesaplardır. Her CSS alanı yalnızca bir CSS grubuna ait olabilir.
  • Merchant Center hesapları, CSS alanlarının Alışveriş reklamları yayınladığı satıcılardır. CSS'ler, çok müşterili hesaplar (MCA'lar) ve bireysel satıcı hesapları gibi birkaç farklı Merchant Center hesabı türüyle ilişkilendirilebilir. Her Merchant Center hesabı yalnızca bir CSS alanıyla ilişkilendirilebilir. Farklı Merchant Center hesabı türleri hakkında daha fazla bilgi için Comparison Shopping Service Center'daki hesap türleri bölümüne bakın.

CSS etiketi türleri

CSS'ler iki tür etiket kullanır:

  • Manuel etiketler, CSS alanları tarafından Merchant Center hesaplarına, CSS grupları tarafından ise CSS alanlarına oluşturulup atanır.
  • Otomatik etiketler, CSS Center tarafından otomatik olarak oluşturulur ve Merchant Center hesaplarına atanır. Otomatik etiketler, farklı hesap metriği türleri için kullanılabilir ve hem önemli hesapları hem de önemli hesap etkinliklerini tanımlamanıza yardımcı olabilir.

Kullanılabilir otomatik etiketler dahil etiket türleri hakkında daha fazla bilgi için Comparison Shopping Service Center'da hesap etiketlerini kullanma bölümüne bakın.

CSS'ler için Content API işlevleri ve uç noktaları

Content API, CSS'ler için aşağıdaki uç noktaları sunar:

accounts uç noktalarını CSS alanı olarak çağırırken aşağıdaki koşullara dikkat edin:

  • CSS alanları, merchantId yerine cssId bilgilerini sağlamalıdır.
  • CSS alanları, view=CSS sorgu parametresi sağlamalıdır.
  • CSS alanları, ilişkilendirilmiş Merchant Center hesap kimliklerini accountId olarak sağlamalıdır.

Örnek: Etiket oluşturma

Yeni bir etiket oluşturmak için accounts.labels.create yöntemini kullanabilirsiniz. Etiketler, CSS alanlarına ve Merchant Center hesaplarına uygulanabilir. Bununla birlikte, farklı hesap türlerinin etiketleri ayrıdır ve birbirlerinin yerine kullanılamazlar. Alanla ilişkilendirilmiş Merchant Center hesaplarına uygulanabilecek alan düzeyinde bir etiket oluşturmak için etiketi oluştururken CSS alanı kimliğini accountId olarak kullanın. Grupla ilişkilendirilmiş CSS alanlarına uygulanabilecek grup düzeyinde bir etiket oluşturmak için etiketi oluştururken CSS grup kimliğini accountId olarak kullanın.

Aşağıdaki örnekte, alanla ilişkili Merchant Center hesaplarına uygulanabilecek alan düzeyinde anahtar hesapları etiketinin nasıl oluşturulacağı gösterilmektedir. Etiketi oluşturmak için aşağıdaki URL'yi ve istek gövdesini kullanarak bir POST isteğinde bulunun:

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

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

Örnek: Merchant Center hesabına etiket uygulama

Bir CSS alanıyla ilişkili Merchant Center hesabına etiket atamak için accounts.updatelabels yöntemini kullanabilirsiniz. Aşağıdaki örnek, önceki örnekte oluşturulan key-accounts etiketinin en önemli Merchant Center hesaplarınızdan birine nasıl uygulanacağını gösterir.

Etiketi uygulamak için aşağıdaki URL'yi kullanarak bir POST isteği gönderin ve gövde isteğinde bulunun:

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

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

Örnek: Merchant Center hesaplarını filtrelemek için etiketleri kullanma

Bir CSS alanıyla ilişkili Merchant Center hesaplarına etiket oluşturup bu etiketleri uyguladıktan sonra, accounts.list yöntemini kullanabilir ve yalnızca bu etikete sahip hesapları döndürmek için isteğinizde etiket sorgu parametresini iletebilirsiniz. Aşağıdaki örnekte, Etiket oluşturma örneğinde oluşturulan key-accounts etiketinin id (123) öğesi kullanılarak bir CSS alanıyla ilişkili Merchant Center hesaplarının nasıl filtreleneceği gösterilmektedir. Hesapları almak için aşağıdaki URL'yi kullanarak bir GET isteğinde bulunun:

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

İsteğin gövdesine gerek yoktur.

Örnek: CSS alanına etiket uygulama

Bir CSS grubuyla ilişkili bir CSS alanına etiket atamak için csses.updatelabels yöntemini de kullanabilirsiniz. Aşağıdaki örnekte, en önemli CSS alanı hesaplarınızdan birine accounts.labels.create yöntemi kullanılarak oluşturulan key-domains grup düzeyinde bir etiketin nasıl uygulanacağı gösterilmektedir. CSS alanları ve Merchant Center hesapları için etiketlerin ayrı olduğunu unutmayın. Grup düzeyindeki etiketler, accountId olarak bir CSS grup kimliği kullanılarak oluşturulmalıdır.

Etiketi uygulamak için aşağıdaki URL'yi kullanarak bir POST isteği gönderin ve gövde isteğinde bulunun:

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

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