Merchant Center hesabınızla ilgili canlı verileri doğrudan tercih ettiğiniz kodlama asistanından alın. Entegre geliştirme ortamınızda (IDE) veya özel aracı çerçevesinde artık Model Context Protocol (MCP) hizmetini kullanarak Merchant Center verilerinize erişebilir ve bu verileri yönetebilirsiniz. Bu hizmet, kodlama asistanınızın veya aracınızın Merchant Center verilerinizde salt okunur ve güvenli yazma işlemleri gerçekleştirmesini sağlayarak sorunları teşhis etmesine, programları kontrol etmesine ve yetkili, canlı bağlamla raporları sorgulamasına olanak tanır.
Protokolün kendisi hakkında daha fazla bilgi için Model Context Protocol standardına bakın.
Güvenlik ve erişim denetimi
Satıcı verileri MCP sunucusu, güvenlik öncelikli olarak tasarlanmıştır:
- Kimlik doğrulama: Araç yürütme işlemi, standart Merchant API kimlik doğrulaması ile sıkı bir şekilde yönetilir. Bu işlem için OAuth 2.0 veya hizmet hesabı kimlik bilgileri gerekir.
- Yürütme Güvenliği: Araç şemalarının aracınız tarafından geniş kapsamlı bir şekilde görülebilmesine rağmen, herhangi bir aracın gerçek yürütülmesi son derece güvenlidir ve belirli API kimlik bilgileriniz tarafından kesinlikle kısıtlanır.
Dikkat edilecek önemli noktalar
Bu araçları kullanmadan önce aşağıdaki en iyi uygulamaları ve sınırlamaları inceleyin:
Değişiklikler ve yayınlar
Sürüm notlarındaki değişiklikler hakkında yayınlar paylaşacağız ancak bu değişiklikler, desteğin sonlandırılma süresi olmadan hemen gerçekleşebilir.
Güvenli test
Bu araçları canlı üretim ortamında kullanmadan önce test hesabı veya canlı olmayan bir hesapla deneme yapmanızı öneririz.
Paylaşılan kota
MCP sunucusu, standart Merchant API çağrılarınızla aynı kota havuzunu paylaşıyor. Çalışan aracılar, özellikle veri kaynağı getirme işlemleri için kotayı hızlı bir şekilde tüketebilir. Üretim hizmetinde kesintileri önlemek için test hesabı kullanmanızı önemle tavsiye ederiz.
Araç filtreleme ve güvenlik
Google, gelecekte bu MCP sunucusuna yeni araçlar (yazma özellikleri dahil) ekleyebilir. Yapay zeka aracınızın yeni veya riskli araçları otomatik olarak ve istemeden yürütmesini önlemek için istemcinizi tüm araç setini kullanıma sunmak yerine yerleşik araç filtreleme için açıkça yapılandırmanızı önemle tavsiye ederiz.
Kapsam ve sınırlamalar
- Salt Okunur Odak: Bu ilk aşamada güvenlik önlemi olarak araçlar, kesinlikle salt okunur işlemler ve düşük riskli yazma araçlarıyla (ör. veri kaynağı oluşturma) sınırlıdır.
Kullanılabilen özellikler
Aşağıdaki işlemleri temsilci gibi davranarak gerçekleştirmek için Merchant Data MCP sunucusunu kullanabilirsiniz:
- Belirli ürünlerle ilgili ayrıntılı durumu ve raporlama bağlamını tam kaynak adlarını kullanarak alın.
- Birden fazla ürünü listeleyin ve arayın.
- Arama raporları aracılığıyla sorgu performans verileri, ürün durumları ve fiyat analizleri.
- Veri kaynaklarının yükleme durumunu listeleme, oluşturma, getirme ve kontrol etme
- Ürün görünürlüğünü veya programa katılımı etkileyen hesap düzeyindeki sorunları belirleyin.
- Envanterinizdeki ürünlerin onaylanmamasının toplu nedenlerini listeleyin.
- Belirli Merchant Center programları için etkin bölgeleri, karşılanmayan koşulları ve katılım durumunu kontrol edin.
- Öğeler, resimler ve kargo ile ilgili otomatik iyileştirme ayarlarını inceleyin.
Kurulum
IDE'nizi veya kodlama asistanınızı Merchant Data MCP sunucusuna bağlamak için MCP istemci ayarlarınızı güncelleyin. Örneğin, Claude Desktop, Antigravity, Visual Studio Code veya özel aracı çerçeveniz için mcp.json dosyasını güncelleyin.
Yerel MCP sunucusu kurulumu için hizmet hesabı gerekir. Bu gözetimsiz yerel yürütme için standart kullanıcı OAuth desteklenmez. Bir hizmet hesabı oluşturmanız, JSON özel anahtar dosyasını indirmeniz ve belirli Merchant Center Kimliğinizle birlikte bu dosyanın yolunu bağımsız değişken olarak sağlamanız gerekir.
Hizmet hesabı oluşturma ve indirmeyle ilgili ayrıntılı talimatlar için Hizmet Hesapları Kılavuzu'na bakın.
İstemci yapılandırması
Yapılandırma kurulumları:
Antigravity
Antigravity belgelerindeki talimatları uygulayın.
{
"mcpServers": {
"merchant-data-mcp": {
"command": "npx",
"args": [
"-y",
"@google/merchant-data-mcp",
"--credentials",
"/path/to/your/service-account-file.json"
]
}
}
}
Claude Desktop
Claude Desktop dokümanlarındaki talimatları uygulayın.
{
"mcpServers": {
"merchant-data-mcp": {
"command": "npx",
"args": [
"-y",
"@google/merchant-data-mcp",
"--credentials",
"/path/to/your/service-account-file.json"
]
}
}
}
Örnek kullanım senaryoları
Merchant Data MCP sunucusu, aracınızın canlı Merchant Center verilerinizle etkileşim kurmasını sağlar. Aşağıda, olası bazı yaygın durumlar verilmiştir:
1. senaryo: Ürün retlerini teşhis etme
Belirli bir ürünün Google arama sonuçlarında neden gösterilmediğini anlamak istiyorsunuz.
Kullanıcı istemi:
Neden 'offer123' teklif numaralı ürünüm onaylanmadı?
MCP ile temsilci davranışı:
- Aracı, ürün durumunu bulmak için
list_productsveyaget_product_by_nameçağrısı yapar. - MCP sunucusu,
issueslistesi de dahil olmak üzere ürün durumunu döndürür (örneğin, "Yanlış fiyat biçimi" veya "Eksik kargo değeri"). - Ajan, sorunları analiz eder ve temel nedeni açıklayarak nasıl düzeltileceği konusunda önerilerde bulunur (ör. fiyat bilgilerini güncelleme).
Senaryo 2: Otomatik iyileştirmeleri kontrol etme
Otomatik kargo iyileştirmelerinizin etkin olup olmadığını doğrulamak istiyorsanız.
Kullanıcı istemi:
"Otomatik kargo iyileştirmelerim etkin mi?"
MCP ile temsilci davranışı:
- Aracı, hesap düzeyindeki ayarları almak için
get_automatic_improvementsişlevini çağırır. - MCP sunucusu, resim, öğe ve kargo iyileştirmelerinin durumunu gösteren yapılandırmayı döndürür.
- Ajan, kargo iyileştirmelerinin etkin olduğunu onaylar veya devre dışıysa nasıl etkinleştirileceğini açıklar.
3. senaryo: Sorgu performansı metrikleri
Merchant Center kullanıcı arayüzünde gezinmeden son performansınızı hızlıca kontrol etmek istiyorsunuz.
Kullanıcı istemi:
"Geçen hafta tıklama sayısına göre en iyi performansı gösteren 5 ürünümü göster."
MCP ile temsilci davranışı:
- Aracı,
product_performance_viewtablosunu hedefleyen,clicks DESCile sıralayan ve5ile sınırlayan bir Merchant Center Sorgu Dili (MCQL) sorgusu oluşturur. - Aracı, oluşturulan sorguyla
report_searchişlevini çağırır. - MCP sunucusu, sorguyu canlı raporlama veritabanında yürütür ve satırları döndürür.
- Temsilci, sonuçları sizin için temiz bir Markdown tablosu olarak biçimlendirir.
Kullanılabilir araçların ayrıntılı listesi
MCP sunucusu, aşağıdaki araçları aracınıza sunar:
| MCP Aracı | Açıklama |
|---|---|
get_product_by_name |
Tam ürün kaynağı adını kullanarak belirli bir satıcıyla ilgili ürün bilgilerini alın. Raporlama bağlamını ve olası ürün düzeyindeki sorunları içeren ayrıntılı ürün durumunu döndürür. |
list_products |
Belirli bir satıcı için birden fazla ürünü listeleyin veya arayın. Raporlama bağlamını ve olası ürün düzeyindeki sorunları içeren ayrıntılı ürün durumunu döndürür. |
report_search |
Performans metriklerini, ürün durumlarını ve fiyat analizlerini almak için raporlama tablolarını sorgulayın. Ayrıntılar için Raporlar kılavuzuna bakın. |
list_data_sources |
Belirli bir satıcı için veri kaynaklarını listeler. |
get_data_source |
Belirli bir veri kaynağının ayrıntılarını alma |
create_data_source |
Belirli bir satıcı için veri kaynağı oluşturun. |
fetch_data_source |
Belirli bir satıcı için bir veri kaynağıyla ilişkili dosyayı getirin ve işleyin. |
get_file_upload |
Belirli bir veri kaynağı için en son dosya yükleme işleminin durumunu alın. |
list_accounts |
Belirli bir kullanıcının hesaplarını listeler. |
list_account_issues |
Hesap genelindeki sorunları belirlemek için belirli bir satıcıyla ilgili hesap düzeyindeki sorunları listeleyin. |
list_programs |
Katılım durumu, etkin bölgeler ve karşılanmayan tüm koşullar dahil olmak üzere belirli bir satıcıya ait programları listeler. |
list_aggregated_product_issues |
Ürün verilerinizin genel durumunu izlemek için ürün düzeyindeki sorunları toplu olarak listeleyin. |
get_automatic_improvements |
Öğe güncellemeleri, resim iyileştirmeleri ve kargo iyileştirmeleri gibi otomatik iyileştirme ayarlarını kullanın. |