İstemci kitaplığı oluşturma

Content API for Shopping'in resmi halefi olan Merchant API ile tanışın. Merchant API beta sürümündedir.

Merchant API'nin yeni özellikleri, önemli doküman güncellemeleri, hata düzeltmeleri ve sürüm güncellemeleri hakkında bilgi edinmek için son duyuruları inceleyin.

İşletmenizin ve ürünlerinizin Google'da nasıl göründüğünü nasıl yönetebileceğinizi ve verilere, analizlere ve benzersiz özelliklere geniş ölçekte programatik erişim elde edebileceğinizi öğrenmek için Merchant API'yi kullanmaya başlama başlıklı makaleyi inceleyin.

Alışveriş için Content API'yi ayarlamak üzere Google API istemci kitaplıklarını kullanmanızı öneririz. Bu kılavuzda örnek olarak Python Content API istemci kitaplıkları kullanılmıştır ancak bu kitaplıklar birçok popüler programlama dilinde kullanılabilir ve kimlik doğrulama, istek gönderme ve yanıtları ayrıştırma gibi yaygın API görevlerini basitleştirir. Diğer diller için istemci kitaplıkları oluşturma hakkında yardım almak isterseniz GitHub'daki googleads/googleads-shopping-samples deposunda ilgili dilin README.md dosyasını inceleyin.

Not: Örnek kodu Python'da kullanmak için gerekli olan birkaç kitaplığı yüklemeniz gerekir. Bu nedenle, devam etmeden önce bir Python sanal ortamı oluşturmanızı öneririz. Daha fazla bilgi için pip ve sanal ortamları kullanarak paket yükleme başlıklı makaleyi inceleyin.

Python için Google API istemci kitaplığını ayarlamak üzere aşağıdaki adımları tamamlayın:

1. İstemci kitaplığının yapılandırma ve kimlik doğrulama dosyaları için bir dizin oluşturun. Ana dizininizde aşağıdaki dizinleri oluşturun:

   ~/shopping-samples/content/

   Not: Bu yol ve 5. adımda oluşturulan merchant-info.json dosyasının dosya adı, 7. adımda indirilen Content API örnekleri dizininde bulunan python/shopping/content/common.py dosyasında tanımlanır.

2. Hizmet hesabı kimlik bilgilerinizi indirmek için aşağıdaki adımları uygulayın:

   1. Google API kitaplığına gidin.
   2. Sayfanın üst kısmındaki menüden bir proje seçin. Henüz projeniz yoksa Yeni proje'yi tıklayarak proje oluşturun.
   3. Bu proje için Content API for Shopping'i henüz etkinleştirmediyseniz Google API'leri listesinde API'yi arayıp etkinleştirin.
   4. Soldaki kenar çubuğunda Kimlik bilgileri'ni seçin. Bunu görmek için sol üstteki sola bakan oku tıklamanız gerekebilir.
   5. Hizmet hesabı oluşturmak için Kimlik bilgisi oluştur'u ve ardından Hizmet hesabı'nı seçin.
   6. Yeni hizmet hesabını adlandırın. Bu, hizmet hesabı kimliği için varsayılan kullanıcı adı olarak da kullanılır. Daha sonra kullanmak üzere "@" karakterinden sonraki kısmı da dahil olmak üzere hizmet hesabı kimliğini kaydedin. Oluştur'u tıklayın, ardından projeye ve kullanıcılara erişim vermeyle ilgili isteğe bağlı adımları uygulayıp Bitti'yi tıklayın.
   7. Yeni hizmet hesabınıza erişilebilen Hizmet Hesapları sayfasına yönlendirilirsiniz.

3. JSON özel anahtarı almak için hizmet hesabını, ardından Anahtarlar sekmesini tıklayın. Anahtar ekle > Yeni anahtar oluştur'u tıklayın ve ardından anahtar türü olarak JSON'u seçin. Özel anahtarı bilgisayarınıza indirmek için Oluştur'u tıklayın. Yeni anahtar otomatik olarak indirilir.

4. İndirilen kimlik bilgileri dosyasını service-account.json olarak yeniden adlandırın.

   Not: Bu dosya adı, 7. adımda indirilen Content API örnekleri dizininde python/shopping/content/ altında bulunan _constants.py dosyasında tanımlanır.

5. service-account.json dosyasını home directory/shopping-samples/content/ dizinine taşıyın.

6. home directory/shopping-samples/content/ konumunda boş bir merchant-info.json dosyası oluşturun.

7. merchant-info.json dosyasına aşağıdaki metni ekleyin:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. Yeni hizmet hesabını Merchant Center hesabınıza kullanıcı olarak ekleyin. Üçüncü taraf geliştiriciyseniz bu adımı müşterinizin sizin için yapması gerekir.

   1. Merchant Center hesabınıza gidin.
   2. Merchant Center hesabınızın ayarlarında Kullanıcılar ve erişim'i seçin.

   3. + Kullanıcı ekle'yi tıklayın ve yeni kullanıcının e-posta adresi olarak hizmet hesabı kimliğini kullanın.

      Not: Hizmet hesabı kimliğini daha önce not etmediyseniz Hizmet Hesapları yönetim sayfasına gidip oluşturduğunuz projeyi seçin.

   4. Accounts hizmetinin kullanımı için yönetici erişimi gerekir. Bu nedenle Yönetici'yi seçin.

   5. Tercihleri kaydetmek ve kullanıcı listesine dönmek için Kullanıcı ekle'yi tıklayın. Hizmet hesabı kimliği, seçilen kullanıcı rolüyle listelenir.

   6. Eklemek istediğiniz diğer tüm hizmet hesapları için bu işlemi tekrarlayın.

9. googleads/googleads-shopping-samples GitHub deposunu bilgisayarınızdaki herhangi bir konuma klonlayın (veya indirip açın). Bu konum, ana dizininizde veya ~/shopping-samples/content/ içinde olmak zorunda değildir.

10. Depoyu indirip sıkıştırmasını açtıysanız depoyu klonlamak yerine sıkıştırmasını açtığınız dizini googleads-shopping-samples olarak yeniden adlandırın.

11. Gerekli örnek bağımlılıkları yüklemek için bir terminal penceresinde googleads-shopping-samples/python/ adresine gidin ve aşağıdaki komutu çalıştırın:

    pip install -r requirements.txt
    

Artık Python için Google API istemci kitaplığını yapılandırdınız ve Content API ile kullanmaya hazırsınız. Sonraki bölümde, yeni bir ürün ekleme isteği oluşturup göndereceksiniz.