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şkili hesaplarını etiketler 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 karşılıklarını sağlar.

CSS'ler hakkında daha fazla bilgi için Karşılaştırmalı Alışveriş Hizmetleri başlıklı makaleyi inceleyin. CSS Center'da etiketlerle çalışma hakkında bilgi edinmek için Comparison Shopping Service Center'da hesap etiketleri kullanma başlıklı makaleyi inceleyin.

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 en üst düzey hesaplardır.
  • CSS alanları, satıcılar adına Alışveriş reklamları yayınlayan CSS'lerin kendi hesaplarıdır. Her CSS alanı yalnızca bir CSS grubuna ait olabilir.
  • Merchant Center hesapları, CSS alanlarının Alışveriş reklamları yerleştirdiği satıcılardır. CSS'ler, çok müşterili hesaplar (MCA'lar) ve bireysel satıcı hesapları dahil olmak üzere çeşitli Merchant Center hesaplarıyla ilişkilendirilebilir. Her Merchant Center hesabı yalnızca bir CSS alanı ile ilişkilendirilebilir. Farklı Merchant Center hesap türleri hakkında daha fazla bilgi için Comparison Shopping Service Center'daki hesap türleri başlıklı makaleyi inceleyin.

CSS etiket türleri

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

  • Manuel etiketler, Merchant Center hesaplarına CSS alanları, CSS alanlarına ise CSS grupları tarafından oluşturulup atanır.
  • Otomatik etiketler, CSS Center tarafından otomatik olarak oluşturulur ve Merchant Center hesaplarına atanır. Farklı türlerdeki hesap metrikleri için otomatik etiketler kullanılabilir. Bu etiketler, önemli hesapları ve önemli hesap etkinliklerini belirlemenize yardımcı olabilir.

Mevcut otomatik etiketler de dahil olmak üzere etiket türleri hakkında daha fazla bilgi edinmek için Comparison Shopping Service Center'da hesap etiketlerini kullanma başlıklı makaleyi inceleyin.

CSS'ler için Content API işlevi 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 sağlamalıdır.
  • CSS alanları, view=CSS sorgu parametresini sağlamalıdır.
  • CSS alanları, ilişkili 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. Ancak farklı hesap türlerinin etiketleri ayrıdır ve birbirinin yerine kullanılamaz. Alana bağlı Merchant Center hesaplarına uygulanabilecek bir alan düzeyi etiketi oluşturmak için etiketi oluştururken accountId olarak CSS alanı kimliğini kullanın. Gruba bağlı CSS alanlarına uygulanabilen grup düzeyinde bir etiket oluşturmak için etiketi oluştururken accountId olarak CSS grubu kimliğini kullanın.

Aşağıdaki örnekte, alan düzeyi bir önemli hesap etiketi oluşturma işlemi gösterilmektedir. Bu etiket daha sonra alanla ilişkili Merchant Center hesaplarına uygulanabilir. Etiketi oluşturmak için aşağıdaki URL'yi ve istek gövdesini kullanarak bir POST isteği gönderin:

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

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

Örnek: Bir Merchant Center hesabına etiket uygulama

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

Etiketi uygulamak için POST isteğinde bulunun. İsteği aşağıdaki URL ve istek gövdesini kullanarak yapın:

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ını oluşturup etiket uyguladıktan sonra accounts.list yöntemini kullanabilir ve yalnızca bu etikete sahip hesapları döndürmek için isteğinizde etiket sorgusu parametresini iletebilirsiniz. Aşağıdaki örnekte, Etiket oluşturma örneğinde oluşturulan key-accounts etiketinin id (123) 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 GET isteği gönderin:

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

İstek metni gerekmez.

Örnek: CSS alanına etiket uygulama

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

Etiketi uygulamak için POST isteğinde bulunun. İsteği aşağıdaki URL ve istek gövdesini kullanarak yapın:

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

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