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.labels
: CSS alanı ve Merchant Center hesaplarına uygulanacak etiketleri oluşturmanızı, almanızı ve değiştirmenizi sağlar. Örnek için Etiket oluşturma bölümüne bakın.accounts.updatelabels
: Tek bir Merchant Center hesabına etiket uygulamanıza olanak tanır. Örnek için Merchant Center hesabına etiket uygulama bölümüne bakın.accounts.list
: Her bir hesaba uygulanan etiketler de dahil olmak üzere, bir CSS alanıyla ilişkili tüm Merchant Center hesaplarını almanıza olanak tanır. İlişkili hesapların bir alt kümesini almak içinid
etiketine göre de filtreleme yapabilirsiniz. Bir örnek görmek için Merchant Center hesaplarını filtrelemek için etiketleri kullanma bölümüne bakın.accounts.get
: Tek bir Merchant Center hesabına uygulanan etiketleri almanızı sağlar.csses
: Etiketler ile CSS alanları arasındaki ilişkilendirmeleri görüntülemenize ve yönetmenize olanak tanır. Örnek için CSS alanına etiket uygulama bölümüne bakın.
accounts
uç noktalarını CSS alanı olarak çağırırken aşağıdaki koşullara dikkat edin:
- CSS alanları,
merchantId
yerinecssId
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’
}