MCP kullanarak API entegrasyonu ve Code Assist Toolkit

Tercih ettiğiniz kodlama asistanından Merchant API hakkında bağlamsal bilgiler alın. Entegre geliştirme ortamınızda (IDE) artık Model Context Protocol (MCP) hizmetini kullanarak geliştirici dokümanı entegrasyonuna erişebilirsiniz. Bu hizmet, kodlama asistanınıza resmi Google API belgelerinden yetkili bağlam sağlayarak entegrasyon ve taşıma iş akışları için geliştirme sürecinizi hızlandırır.

Protokolün kendisi hakkında daha fazla bilgi için Model Context Protocol standardına bakın.

Genel Bakış

Content API for Shopping'den Merchant API'ye geçiş yaparken veya yeni bir entegrasyon oluştururken yeni hizmet yapılarını, kaynak adlarını ve yöntemlerini anlamanız gerekir. MCP hizmeti, kodlama asistanınıza resmi belgeler ve kod örnekleri sağlayarak bu süreci basitleştirir.

Hizmet, son derece özelleşmiş bir Almayla Artırılmış Üretim (RAG) arka ucu kullanır. MCP özellikli IDE kodlama asistanınıza Merchant API ile ilgili bir soru sorduğunuzda hizmet, Google'ın resmi kaynaklarından en alakalı metin ve kod snippet'lerini alıp kodlama asistanınıza bağlam olarak döndürür. Bu sayede, geliştirme ortamınızdan hiç ayrılmadan asistanınızın doğru ve güncel yanıtlar vermesini sağlayabilirsiniz.

İşleyiş şekli

MCP kullanılarak geliştirici dokümanı entegrasyonu, modern ve yapay zeka destekli bir geliştirme iş akışına entegre olur:

  1. MCP ile uyumlu kodlama asistanınızda veya aracınızda bir soru sorarsınız. Bu, doğal dilde bir soru, Merchant API kod örneği isteği veya hatta kodunuzu doğrudan Merchant API'ye çevirme isteği olabilir.
  2. Kodlama asistanınız, bağlam için MCP uç noktasına bir istek gönderir.
  3. MCP hizmeti, en alakalı bilgileri bulmak için resmi Merchant API belgeleri, kılavuzlar ve kod örneklerinden oluşan dizine eklenmiş koleksiyonunda arama yapar.
  4. Bu hizmet, kodlama asistanınıza bağlam olarak bu yetkili snippet'leri döndürür.
  5. Kodlama asistanınız, orijinal sorunuza doğru ve faydalı bir yanıt oluşturmak veya kod çevirme görevini gerçekleştirmek için bu yüksek kaliteli bağlamı kullanır.

Başlarken

MCP'yi kullanmak için aşağıdaki adımları uygulayın:

1. Uyumlu bir araç kullanın

Akışa alınabilir HTTP aktarımını kullanarak Model Context Protocol'ü destekleyen bir IDE veya kodlama asistanı açın.

2. Uç nokta yapılandırması

IDE'nizi veya kodlama asistanınızı MCP'ye bağlamak için sağlanan uzak uç nokta ayrıntılarını kullanın. Bu işlem, aracınızın yapılandırmasına bağlı olarak doğrudan hizmet URL'sini veya MCP tanımını girmenizi gerektirebilir.

Hizmet URL'si:

MCP Server Name: "MAPI Docs MCP"
MCP Server URL:  "https://merchantapi.googleapis.com/devdocs/mcp/"
MCP Server Protocol: "http"

3. Temsilci talimatları ekleme (isteğe bağlı)

Aracınızın MCP kullanarak kodu doğrudan çevirmesini sağlamak için araca System Instructions: MerchantIntegrator Agent Protocol talimatını verin. Bu talimatlar, temsilciye kod çevirisi için MCP'yi nasıl doğru şekilde kullanacağı konusunda rehberlik eder. Aracınıza bağlı olarak bu talimatları sistem talimatları yapılandırmasında veya aracı için ek bir bağlam dosyası olarak sağlayabilirsiniz.

Örnek kullanım senaryoları

MCP, aşağıdaki yaygın kullanım alanlarında iş akışınızı hızlandırabilir.

1. senaryo: products.insert kodunu taşıma

Temsilciden, Content API for Shopping products.insert entegrasyon kodunu doğrudan Merchant API'ye taşımasını isteyebilirsiniz.

Kullanıcı istemi:

"products.insert kodunu Merchant API'ye taşıma"

Aracınıza System Instructions: MerchantIntegrator Agent Protocol ve MCP'ye erişim izni vererek aracınızın Content API for Shopping kodunu doğrudan IDE'nizde Merchant API koduna çevirmesini sağlayabilirsiniz. Bu durumda, eşdeğer çağrı olarak productInputs.insert tanımlanır ve ürün özellikleri eski biçimden Merchant API'nin gerektirdiği yeni biçime eşlenir. Ayrıca, gerekli içe aktarmaları ve bağımlılık yönetimi dosyasını (ör. requirements.txt, pom.xml veya package.json) güncelleyebilir. Ajanı, değişiklikleri yerinde yapmaya veya yeni bir klasör oluşturmaya yönlendirebilirsiniz.

2. senaryo: Eşdeğer işlevleri bulma

Content API for Shopping'i kullanan mevcut bir uygulamanız var ve bu uygulamayı güncellemeniz gerekiyor. Yeni uygulama ve ilgili kod örneği hakkında ayrıntılı bilgi edinmek için belirli bir eski yöntem hakkında soru sorabilirsiniz.

Kullanıcı istemi:

"Content API for Shopping'deki accountstatuses.get yöntemi için Merchant API'deki eşdeğer yöntem nedir?"

MCP hizmeti, resmi taşıma kılavuzlarından ve referans dokümanlarından bağlam bilgisi sağlar. Böylece yardımcınız, yeni API adı accounts.issues da dahil olmak üzere ayrıntılı bir yanıt verebilir.

Senaryo 3: Kod örneği bulma

Yeni bir özellik uyguluyorsunuz ve takip etmeniz gereken pratik bir örneğe ihtiyacınız var.

Kullanıcı istemi:

"Show me a Python code sample for adding a new shipping service using Merchant API." (Merchant API'yi kullanarak yeni bir kargo hizmeti eklemeyle ilgili Python kodu örneği göster.)

MCP hizmeti, resmi Google GitHub depolarından ve geliştirici kılavuzlarından ilgili kod örneklerini alır. Bu şekilde asistanınız, eksiksiz ve uyarlanmaya hazır bir kod bloğu sunabilir.

4. senaryo: API kavramlarını anlama

Yeni bir kavramla karşılaşırsanız veya bir kaynağın yapısını ya da genel Merchant API kalıbını anlamak isterseniz.

Kullanıcı istemi:

"Merchant API'yi kullanarak bir ürünün envanterini nasıl güncellerim?"

MCP hizmeti, ürün kaynağı dokümanlarındaki ve ilgili kılavuzlardaki bağlamı döndürür. Ardından asistanınız, accounts.productInputs.insert yönteminin nasıl kullanılacağını açıklayabilir ve yalnızca accounts.productInputs.insert ile güncellemeniz gereken envanterle ilgili alanları içeren kısmi ürün kaynağını sağlayabilir.productId

"Uygulama çağrılarımı Merchant API ile nasıl yetkilendiririm?"

MCP hizmeti, farklı yetkilendirme yöntemlerini kapsayan resmi kimlik doğrulama kılavuzlarından bağlam alır. Ardından asistanınız, sunucudan sunucuya etkileşimler için hizmet hesabı kullanma veya kullanıcı adına işlem yaparken OAuth 2.0 istemci kimliği kullanma gibi mevcut temel seçenekleri açıklayabilir.

5. senaryo: API değişikliklerine uyum sağlama

Merchant API, Content API for Shopping'den farklı olan yeni kalıplar (ör. istekleri gruplandırma) sunar. Content API for Shopping belirli custombatch yöntemleri kullanırken Merchant API, yerleşik ve genel bir HTTP toplu işleme özelliği kullanır.

Kullanıcı istemi:

"Merchant API'de products.custombatch işlemini yapmanın yeni yolu nedir?"

MCP hizmeti, Eşzamanlı istekler için kodu yeniden düzenleme başlıklı makaleden bağlam bilgisi alır. Bu makalede, Merchant API'de özel custombatch yöntemlerinin olmadığı açıklanır. Bunun yerine, Content-Type ile HTTP toplu işleme özelliğini kullanma hakkında multipart dokümanı sağlar. Ardından asistanınız, https://merchantapi.googleapis.com/batch/{sub-api}/v1 uç noktasına gönderilen ve birden fazla API çağrısı içeren tek bir HTTP isteğinin nasıl oluşturulacağını açıklayabilir ve çok bölümlü isteğin nasıl yapılandırılacağına dair bir örnek verebilir. Bu sayede, kafa karıştırıcı olabilecek bir taşıma görevi, rehberli bir sürece dönüştürülür.

6. senaryo: Raporlama sorgusunu çevirme

Aracıdan, Content API for Shopping'deki bir raporlama sorgusunu Merchant API'ye çevirmesini isteyebilirsiniz.

Kullanıcı istemi:

"Bu raporlama sorgusunu Content API'den Merchant API'ye taşıyın: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'"

MCP hizmeti, en son raporlama referans belgelerini, geliştirici kılavuzlarını ve taşıma kılavuzlarını alır. Bu bilgilere göre sorguyu yeni yapıya dönüştürür ve alanları yeni adları ve değerleriyle günceller.

Bilgi bankası kaynakları

MCP hizmeti, sağladığı bağlamın doğru ve güvenilir olmasını sağlamak için bilgi tabanını yalnızca herkese açık ve resmi kaynaklardan oluşturur. Hizmet, resmi geliştirici sitesinin ve kod örneği deposunun tüm içeriğini (ör. aşağıdakiler) indeksler:

Önceki
Client libraries
Sonraki
Overview