Başla

Manufacturer Center (MfC) API, uygulamaların doğrudan Manufacturer Center platformuyla etkileşim kurmasına olanak tanır. Başlamanıza yardımcı olmak için Java ve .NET'te kod örnekleri sunuyoruz.

Bu kılavuz, Manufacturer Center API'yi kullanarak ilk uygulamanızı oluşturmanıza yardımcı olacaktır. Kodlamaya başlamadan önce yapmanız gereken birkaç şey var.

REST Desteği

REST API'miz, 2 farklı kaynak türü için temel CRUD işlemlerini destekler:

Bu belgenin geri kalanı ağırlıklı olarak Product için yazılır ancak ProductCertification için benzer bir süreç izlenir.

Manufacturer Center hesabınızı oluşturun

  1. Manufacturer Center Hesabı oluşturun.

  2. Bu Manufacturer Center hesabını oluştururken hangi e-posta adresini kullandığınızı unutmayın. Daha sonra buna ihtiyacınız olacak. Ekran görüntülerinde manufacturer_user@example.com olarak temsil edildiğini görürsünüz.

İlk API isteğinizi yapın (kod satırı olmadan!)

  1. Accounts.Products.list için geliştirici dokümanlarımızdaki APIs Gezgin'e gidin.

  2. Giriş yapmış olduğunuz Google hesabının, Ayarlar sekmesindeki "Kullanıcılar" ayarında listelendiğinden emin olun.

  3. API Gezgini'ndeki Kimlik Doğrulama açılır menüsünde Google OAuth 2.0'ın seçili olduğundan emin olun:

  4. Formun "üst" alanına accounts/{account_id} değerini girip {account_id} yerine Manufacturer Center hesabınızdaki Üretici Kimliği'ni girin. Ardından Yürüt'ü tıklayın.

  5. Başarılı bir yanıt görmeniz gerekir. Tebrikler! İlk Manufacturer Center API isteğinizi gönderdiniz.

  6. Manufacturer Center hesabınızda henüz ürün yoksa listede de ürün bulunmaz. Bu noktada diğer isteklere atlayabilir ve neler yaptıklarına göz atabilirsiniz. Bu bir RESTful API olduğundan tüm istekler benzer şekilde çalışır. Ürünleriniz hazır olduğunda bir sonraki adım Accounts.Products.get'ı denemektir.

Google API Konsol Projesi oluşturma

Manufacturer Center API'ye yapılan istekler API Konsolu projeniz üzerinden yapılır. Burada kendi Manufacturer Center hesabınıza erişeceğinizi varsayıyoruz. Bu nedenle, kimlik doğrulama akışını basitleştirmek için hizmet hesaplarını kullanmanızı öneririz. Manufacturer Center hesabınızla kullanılacak yeni bir hizmet hesabı oluşturmayla ilgili ayrıntılar için Hizmet Hesapları Kılavuzu'na bakın.

Java kullanan ilk yetkilendirilmiş API isteğiniz

Hizmet hesabı oluşturduğunuza ve hizmet hesabı kimliğini Manufacturer Center hesabınıza eklediğinize göre artık mevcut Samples kodunu kullanarak hesabınıza erişebilirsiniz. Bu kılavuzda, API'nin nasıl kullanıldığını göstermek için Java örnekleri kullanılmaktadır.

  1. Henüz yapmadıysanız Apache Maven'i yükleyin.

  2. Alışveriş örneklerimizi GitHub sayfamızdan indirin.

  3. java alt dizininden Java örneklerini oluşturun:

    $ mvn compile

  4. Şimdi ProductsListSample kodunu çalıştırın (ProductCertification için örnek ListProductCertificationsSample olmalıdır):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  5. Kaynak dosyalara eşlik eden BENİOKUOKU bölümündeki yapılandırma talimatlarını uygulamadıysanız örnek yapılandırma bulunamadığını belirten bir hata alırsınız. Yapılandırma dizinini oluşturmak ve bu dizini uygun bilgilerle doldurmak için BENİOKU'daki talimatları uygulayın. Hizmet hesabınızı oluştururken indirdiğiniz JSON dosyası, service-account.json dosya adıyla o dizine yerleştirilmelidir. Aşağıdaki ortam değişkenini ayarlayarak koda dosyanızın yerini belirtmeyi unutmayın.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. Artık örnek yapılandırmasını ayarladığınıza göre ProductsListSample kodunu tekrar çalıştırın.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  7. Bu noktada, Java programı yürütme işlemini tamamlamalı ve bulduğu ürünlerin listesini veya hesabınızda ürün olmadığını belirten bir mesajı yazdırmalıdır. "Kullanıcı 1234567890 numaralı hesaba erişemiyor" gibi bir hata mesajı alırsanız büyük olasılıkla hizmet hesabı kullanıcısını Manufacturer Center'da yetkili kullanıcı olarak ayarlamamışsınızdır. API açısından bakıldığında API Konsolu projesi, yetkili Manufacturer Center yöneticileri listesinde olmayan bir kullanıcı adına bir istek gönderdiğinden bu istek elbette reddedilecektir.

  8. Bu salt okunur bir istek olduğundan ProductsListSample öğesini çalıştırmayı istediğiniz kadar deneyebilirsiniz. Hem Java hem de .NET için oluşturduğumuz diğer örnekleri de inceleyebilirsiniz.