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ı etiketleri kullanarak düzenlemesine olanak tanır. CSS alanları, alanla ilişkili Merchant Center hesaplarını listeleyebilir, etiketleyebilir ve filtreleyebilir. CSS grupları, gruba bağlı CSS alanlarını etiketleyebilir ve listeleyebilir. Bu Content API hizmetleri, Comparison Shopping Service Center'da bulunan bazı özelliklerin programatik eşdeğerlerini sağlar.
CCS'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 üst düzey hesaplardır.
- CSS alanları, satıcılar adına Alışveriş reklamları yayınlayan CSS'lerin 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ı da dahil olmak üzere çeşitli Merchant Center hesabı türleriyle 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 edinmek 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, CSS alanlarına göre Merchant Center hesaplarına ve CSS gruplarına göre 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 önemli hesapları ve önemli hesap etkinliklerini belirlemenize yardımcı olabilir.
Kullanılabilir otomatik etiketler dahil olmak üzere etiket türleri hakkında daha fazla bilgi edinmek için Comparison Shopping Service Center'da hesap etiketleri kullanma başlıklı makaleyi inceleyin.
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 etiketler oluşturmanıza, almanız ve değiştirmenize olanak tanır. Örnek için Etiket oluşturma başlıklı makaleyi inceleyin.accounts.updatelabels
: Tek bir Merchant Center hesabına etiket uygulamanıza olanak tanır. Örnek için Merchant Center hesabına etiket uygulama başlıklı makaleyi inceleyin.accounts.list
: Her hesaba uygulanan etiketler 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çin etikete göre de filtreleme yapabilirsinizid
. Örnek için Merchant Center hesaplarını filtrelemek için etiketleri kullanma başlıklı makaleyi inceleyin.accounts.get
: Tek bir Merchant Center hesabına uygulanan etiketleri almanıza olanak tanır.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 başlıklı makaleyi inceleyin.
accounts
uç noktalarını CSS alanı olarak çağırırken aşağıdaki koşullara dikkat edin:
- CSS alanları,
merchantId
yerinecssId
sağlamalıdır. - CSS alanları,
view=CSS
sorgu parametresi sağlamalıdır. - CSS alanları, ilişkili Merchant Center hesap kimliğini
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. Alanla ilişkili Merchant Center hesaplarına uygulanabilecek alan düzeyinde bir etiket oluşturmak için etiketi oluştururken accountId
olarak CSS alan kimliğini kullanın. Grupla ilişkili CSS alanlarına uygulanabilecek grup düzeyinde bir etiket oluşturmak için etiketi oluştururken accountId
olarak CSS grup kimliğini kullanın.
Aşağıdaki örnekte, alan düzeyinde bir temel hesap etiketinin nasıl oluşturulacağı 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
CSS alanıyla ilişkilendirilmiş bir Merchant Center hesabına etiket atamak için accounts.updatelabels
yöntemini kullanabilirsiniz. Aşağıdaki örnekte, önceki örnekte oluşturulan anahtar-hesaplar etiketinin en önemli Merchant Center hesaplarınızdan birine nasıl uygulanacağı gösterilmektedir.
Etiketi uygulamak 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/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şturduktan ve etiketleri uyguladıktan sonra accounts.list
yöntemini kullanabilir ve yalnızca bu etikete sahip hesapları döndürmek için isteğinize etiket sorgu parametresini iletebilirsiniz. Aşağıdaki örnekte, Etiket oluşturma örneğinde oluşturulan anahtar-hesaplar etiketinin id
(123
) özelliği 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ğ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
Bir CSS grubuyla ilişkilendirilmiş bir 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üzeyinde 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 grup kimliği kullanılarak oluşturulmalıdır.
Etiketi uygulamak 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/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}