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ı için standartlaştırılmış ve güvenli bir köprü sağlayarak Merchant Center verilerine dayalı yeni aracı tabanlı deneyimler ve otomatik iş akışları oluşturup düzenlemelerine olanak tanır.

Ö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 önceden haber verilmeksizin 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 ajan tabanlı bir şekilde gerçekleştirmek için Merchant API MCP Access Service'i kullanabilirsiniz:

• Belirli ürünler için 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, fiyatlandırma analizleri, rekabetçi görünürlük 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 başsız 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ı

Merchant API MCP Access Service'ten nasıl yararlanarak ajan tabanlı deneyimler ve otomatik iş akışları oluşturabileceğinizi göstermek için 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:

"Why is my product with offer ID 'offer123' disapproved?" ("Neden 'offer123' teklif kimlikli ürünüm onaylanmadı?")

MCP ile temsilci davranışı:

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

2. senaryo: Otomatik iyileştirmeleri etkinleştirme ayarını inceleme

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 istiyorsanız.

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 çağrısı yapar.

MCP araçları ve açıklamaları

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