Merchant API MCP Access Service (Alfa)

Yeni temsilci tabanlı deneyimler ve otomatik iş akışları oluşturmak için Merchant API Model Context Protocol (MCP) Access Service'i kullanarak Merchant Center verilerinize ve analizlerinize yetkili erişim elde edin.

Genel Bakış

Merchant API MCP Access Service, LLM'ler, aracılar ve kodlama asistanlarının Merchant Center verilerine dayalı yeni aracı deneyimleri ve otomatik iş akışları oluşturup düzenlemesi için standartlaştırılmış ve güvenli bir köprü sağlar.

Özellikle, Merchant Center verilerinize ve Google tarafından oluşturulan raporlara ve analizlere yetkili erişime izin vererek aşağıdaki gibi kullanım alanlarını ele almak için salt okunur ve sınırlı yazma işlemleri gerçekleştirmenize olanak tanır:

• Ürün retlerini teşhis etme ve düzeltme
• Performans raporları ve analizler oluşturma
• Otomatik iyileştirmeleri etkinleştirme seçeneğini inceleyin
• Veri kaynakları oluşturma ve getirme

Güvenlik ve erişim denetimleri

Merchant API MCP Access Service, güvenlik önceliğiyle tasarlanmıştır:

• Kimlik doğrulama: Araç yürütme, standart Merchant API kimlik doğrulaması ile yönetilir ve OAuth 2.0 veya hizmet hesabı kimlik bilgilerini gerektirir. Mümkün olan en kısıtlayıcı erişim haklarına sahip kimlik bilgilerini kullanmanızı öneririz.
• Yürütme Güvenliği: Araç görünürlüğü, bağımsız keşif için kısıtlanmamış olsa da araç yürütme işlemi, belirli API kimlik bilgilerinizle kısıtlanır.
• Koruma önlemleri: Araçlar, güvenlik önlemi olarak yalnızca okuma işlemleri ve düşük riskli yazma araçlarıyla (ör. veri kaynağı oluşturma) sınırlıdır.

Dikkat edilecek önemli noktalar

Merchant API MCP Access Service, alfa sürümündedir. Kapsamı ve özellikleri genişletilecek ve değişebilir.

Başlamadan önce aşağıdaki sınırlamaları ve en iyi uygulamaları inceleyin:

Değişiklikler ve yayınlar

Değişiklikler ön bildirimde bulunulmaksızın yapılabilir ve sürüm notlarında yayınlanır.

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

Merchant API MCP Access Service, standart Merchant API çağrılarınızla aynı kota havuzunu paylaşır. Çalışan aracıların kotası, özellikle veri kaynağı getirme işlemleri için hızlıca tükenebilir. Üretim hizmetinde kesintileri önlemek için test hesabı kullanmanızı önemle tavsiye ederiz.

Araç filtreleme ve güvenlik

Gelecekte özellikle yazma işlemleriyle ilgili yeni özellikler eklenecektir. İstemcinizi, tüm araç setini kullanıma sunmak yerine yerleşik araç filtrelemeyi kullanacak şekilde açıkça yapılandırmanızı önemle tavsiye ederiz.

Kullanılabilir özelliklerin özeti

Aşağıdaki işlemleri temsilci gibi yapmak için Merchant API MCP Access Service'i 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.
• Sorgu performans metrikleri, ürün durumları ve popüler ürünler, fiyat analizleri, görünürlük rekabeti ve YouTube Alışveriş satış ortağı analizleriyle ilgili analizler.
• Ürün görünürlüğünü veya programa katılımı etkileyen hesap düzeyindeki sorunları belirleyin.
• Veri kaynaklarının yükleme durumunu listeleme, oluşturma, getirme ve kontrol etme
• Envanterinizdeki ürünlerin onaylanmamasının toplu nedenlerini listeleyin.
• Öğeler, resimler ve kargo ile ilgili otomatik iyileştirme ayarlarını inceleyin.
• Belirli Merchant Center programları için etkin bölgeleri, karşılanmayan koşulları ve katılım durumunu kontrol edin.

Başlarken

IDE'nizi, kodlama asistanınızı veya aracınızı Merchant API MCP Access Service'e bağlamak için MCP istemci ayarlarınızı güncelleyin. Örneğin, Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code veya özel aracı çerçeveniz için mcp.json dosyasını güncelleyin.

Yerel Merchant API MCP Access Service 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, bu hesabın 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ı:

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Örnek kullanım senaryoları

Temsilci tabanlı deneyimler ve otomatik iş akışları oluşturmak için Merchant API MCP Erişim Hizmeti'nden nasıl yararlanabileceğinizi göstermek amacıyla aşağıdaki senaryoları inceleyin:

Senaryo 1: Ürün retlerini teşhis etme ve düzeltme

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ışı:

1. Aracı, ürün durumunu bulmak için list_products veya get_product_by_name çağrısı yapar.
2. MCP sunucusu, issues listesi de dahil olmak üzere ürün durumunu döndürür (örneğin, "Yanlış fiyat biçimi" veya "Eksik kargo değeri").
3. Ajan, sorunları analiz eder ve temel nedeni açıklayarak nasıl düzeltileceği konusunda önerilerde bulunur (ör. fiyat bilgilerini güncelleme).

2. senaryo: Otomatik iyileştirmeleri etkinleştirme

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ışı:

1. Aracı, hesap düzeyindeki ayarları almak için get_automatic_improvements işlevini çağırır.
2. MCP sunucusu, resim, öğe ve kargo iyileştirmelerinin durumunu gösteren yapılandırmayı döndürür.
3. Ajan, kargo iyileştirmelerinin etkin olduğunu onaylar veya devre dışıysa nasıl etkinleştirileceğini açıklar.

3. senaryo: Performans raporları ve analizler oluşturma

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ışı:

1. Aracı, product_performance_view tablosunu hedefleyen, clicks DESC ile sıralayan ve 5 ile sınırlayan bir Merchant Center Sorgu Dili (MCQL) sorgusu oluşturur.
2. Aracı, oluşturulan sorguyla report_search işlevini çağırır.
3. MCP sunucusu, sorguyu canlı raporlama veritabanında yürütür ve satırları döndürür.
4. Temsilci, sonuçları sizin için temiz bir Markdown tablosu olarak biçimlendirir.

4. senaryo: Veri kaynakları oluşturma ve getirme

Ürün güncellemelerini yüklemek için yeni bir veri kaynağı eklemek istiyorsunuz.

Kullanıcı istemi:

"Satıcı hesabım için "price-updates" adlı bir ek veri kaynağı oluştur."

MCP ile temsilci davranışı:

1. Aracı, yeni feed'i kaydetmek için belirtilen ayarlarla create_data_source işlevini çağırır.
2. MCP sunucusu, veri kaynağını oluşturur ve benzersiz kaynak adını döndürür.
3. Temsilci, indirme ve ilişkili dosyanın işlenmesini tetiklemek için fetch_data_source işlevini çağırır.
4. Temsilci, yükleme ilerleme durumunu izlemek ve öğelerin başarılı işleme durumunu onaylamak için get_file_upload'ı arar.

MCP araçları ve açıklamaları

Merchant API MCP Access Service, aracınıza aşağıdaki araçları sunar: