Başla

Manufacturer Center (MfC) API, uygulamaların doğrudan Manufacturer Center platformu ile etkileşime geçmesini sağlar. 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ı olur. Kodlamaya başlamadan önce yapmanız gereken birkaç şey vardır:

REST Desteği

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

Bu dokümanların geri kalanı çoğunlukla Product (Ürün) için yazılır ancak ProductCertified için süreç benzer olmalıdır.

Manufacturer Center hesabınızı ayarlama

  1. Manufacturer Center Hesabı oluşturun.

  2. Bu Manufacturer Center hesabını oluşturmak için kullandığınız e-postayı mutlaka unutmayın. Daha sonra buna ihtiyacınız olacaktır. Ekran görüntülerinde manufacturer_user@example.com olarak temsil edildiğini göreceksiniz.

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

  1. Accounts.Products.list için geliştirici belgelerimizden API Gezgini'ne gidin.

  2. Giriş yapmış olan 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. accounts/{account_id} değerini, Manufacturer Center hesabınızdaki Üretici Kimliği ile {account_id} yerine, formun "ana" alanına yazın ve Yürüt'ü tıklayın.

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

  6. Manufacturer Center'da henüz ürününüz yoksa listede hiç ürün olmaz. Bu aşamada diğer isteklere atlayıp ne yaptıklarına göz atabilirsiniz. Bu bir RESTful API olduğundan tüm istekler benzer şekilde çalışır. Bir sonraki adımınız, ürün satın aldıktan sonra Accounts.Products.get işlemini denemektir.

Google API Konsolu Projesi Oluşturma

Manufacturer Center API'sine yapılan istekler API Console projeniz üzerinden yapılır. Burada 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 kullanmak üzere yeni bir hizmet hesabı oluşturma hakkında ayrıntılı bilgi için Hizmet Hesapları Kılavuzu'nu inceleyin.

Java kullanan ilk yetkili API isteğiniz

Hizmet hesabı oluşturduğunuza ve Manufacturer Center hesabınıza hizmet hesabı kimliğini eklediğinize göre artık kullanılabilir Örnek kodu 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. GitHub sayfamızdan Alışveriş örneklerimizi indirin.

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

    $ mvn compile

  4. Şimdi ProductsListSample kodunu (ProductCertisation örneği ListProductCertificationsSample olacaktır) çalıştırın:

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

  5. Kaynak dosyalara eşlik eden README'deki yapılandırma talimatlarını izlemediyseniz örnek yapılandırma bulunamadı hatası alırsınız. Yapılandırma dizinini oluşturmak ve uygun bilgilerle doldurmak için README'deki talimatları uygulayın. Hizmet hesabınızı oluştururken indirdiğiniz JSON dosyası, şu dizin adına yerleştirilmelidir: service-account.json. Aşağıdaki ortam değişkenini ayarlayarak kodunuza dosyanızın konumunu eklemeyi unutmayın.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. Örnek yapılandırmasını belirledikten sonra ProductsListSample kodunu tekrar çalıştırın.

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

  7. Bu noktada, Java programının çalıştırılması tamamlanmalı ve bulunan ürünlerin listesi veya hesabınızda hiç ürün bulunmadığına dair bir mesaj yazdırılmalıdır. "Kullanıcı 1234567890 hesabına erişemiyor" gibi bir hata alıyorsanız bunun nedeni büyük olasılıkla hizmet hesabı kullanıcısını Manufacturer Center'da yetkili kullanıcı olarak ayarlamamış olmanızdır. API açısından API Konsolu projesi, yetkili Manufacturer Center yöneticileri listesinde bulunmayan bir kullanıcı adına istek gönderdi. Bu isteği elbette reddeder.

  8. Salt okunur bir istek olduğundan, ProductsListSample öğesini istediğiniz kadar çalıştırmayı deneyebilirsiniz. Ayrıca, hem Java hem de .NET için oluşturduğumuz diğer örnekleri de keşfedebilirsiniz.