Sık Sorulan Sorular

Bu bölümde, Merchant API için geliştirici kaydıyla ilgili sık sorulan sorular ele alınmaktadır.

Genel Kayıt

Kayıt süreci hakkında sık sorulan sorular:

Merchant API'yi kullanmak için geliştirici kaydı zorunlu mu?

Evet. Google'ın hizmet duyuruları ve yeni özelliklerle ilgili bilgiler gibi API'ye özel önemli güncellemeleri gönderebilmesi için geliştirici iletişim bilgilerinizi kaydetmeniz gerekir.

Merchant API'yi yalnızca keşfetmek ve test etmek istiyorsanız kayıt gerektirmeyen Google OAuth Playground ve API Gezgini gibi araçları kullanabilirsiniz.

Ne sıklıkta kaydolmam gerekir?

Kayıt, her Google Cloud projesi için tek seferlik bir kurulumdur. Birden fazla satıcı hesabıyla çalışıyor olsanız da olmasanız da kayıt işlemini yalnızca bir kez yaparsınız ve bu işlem, bağlı Google Cloud projesindeki tüm kullanıcılar ve hizmet hesapları için geçerli olur.

Bir Google Cloud projesi başarıyla kaydedildikten sonra, unregisterGcp yöntemi çağrılarak açıkça kaldırılmadığı sürece bağlantı etkin kalır. API Gezgini veya OAuth Playground gibi Google'a ait paylaşılan projeleri kaydedemezsiniz.

Geliştirici iletişim bilgisi olarak hangi e-posta adresini vermeliyim?

Bireysel bir kurumsal e-posta adresi kullanmanızı öneririz. Alternatif olarak genel grup takma adlarını kullanabilirsiniz. İletişimler gerçek alıcılar için tasarlandığından hizmet hesabı e-postalarını kullanamazsınız. Google, hizmet duyuruları ve yeni özellikler hakkında bilgiler gibi API'ye özel önemli güncellemeler gönderir.

E-posta adresi, Merchant Center hesabında mevcut bir kullanıcıya aitse bu kullanıcıya otomatik olarak API developer rolü verilir. Aksi takdirde, bu adrese davetiye gönderilir.

Geliştiricinin iletişim e-posta adresi alanı, registerGcp yönteminde isteğe bağlıdır. Kayıt sırasında bu alan için bir değer sağlamazsanız Merchant Center kullanıcı arayüzünde veya accounts.users.create yöntemini çağırarak API developer rolüne sahip bir kullanıcı oluşturmanız gerekir.

Geliştiricinin iletişim e-posta adresinin Google Hesabı olması gerekir mi?

Evet. Mevcut bir Google dışı e-postayı kullanmak için Google Hesabı oluşturun kaydolma sürecinde Mevcut e-postanızı kullanın seçeneğini belirleyerek bu e-postayı bir Google Hesabı ile ilişkilendirebilirsiniz. Hizmet hesapları e-posta alamadığından hizmet hesabı e-postalarını kullanamazsınız.

Kayıt çağrısı için kimlik doğrulama ve yetkilendirme işlemlerini nasıl gerçekleştiririm?

Kullanım alanınıza bağlı olarak kayıt çağrısının kimlik doğrulaması ve yetkilendirilmesi için iki farklı kimlik doğrulama senaryosu mevcuttur:

• OAuth 2.0: Birden fazla satıcı hesabını yöneten üçüncü taraf sağlayıcılar veya ajanslar için
• Hizmet hesapları: Kendi Merchant Center hesabınıza erişmek için

Önceki şemada, kayıt çağrısı için iki kimlik doğrulama ve yetkilendirme akışı gösterilmektedir. Aşağıdakilerden birini seçebilirsiniz:

• Google Hesabı ile ilişkilendirilmiş account@email.com gibi bir e-posta adresiyle OAuth kullanma
• sa@project.iam.gserviceaccount.com gibi bir hizmet hesabı kullanma

OAuth'u kullanmaya karar verirseniz:

• E-postanız için Google Cloud projenizde OAuth kimlik bilgileri oluşturun
• Yetkilendiren e-posta adresinin Merchant Center'da bulunduğundan ve ADMIN erişim türüne sahip olduğundan emin olun.

Hizmet hesabı kullanmaya karar verirseniz:

• Hizmet hesabının Google Cloud projenizde bulunduğundan emin olun.
• Hizmet hesabıyla ilişkili e-posta adresinin Merchant Center'da bulunduğundan ve ADMIN erişim türüne sahip olduğundan emin olun.

Doğrudan API çağrılarını veya istemci kitaplıklarını kullanarak kimlik doğrulayan kimliğin güvenlik bağlamı altında kayıt çağrısını gerçekleştirin. Geliştiriciyle iletişime geçmek için bir e-posta adresi sağlayın (ör. developer@email.com).

Kayıt çağrısı başarılı olursa Merchant Center hesabınızda, sağlanan geliştirici e-posta adresi ve API developer rolüyle bir kullanıcı bulunur. Yanıt olarak DeveloperRegistration kaynağını alırsınız.

Kimlik doğrulama e-postası ile geliştirici iletişim e-postası arasındaki fark nedir?

İki e-posta adresi, Merchant API ekosisteminde farklı amaçlara hizmet eder:

• Kimlik doğrulama e-postası: Merchant API'ye istekleri yetkilendirmek için genellikle Google Hesabınızla veya bir hizmet hesabıyla ilişkili bir e-posta adresini kimlik olarak kullanırsınız. Bunun için:
  • Merchant Center hesabınızda bulunur ve ADMIN rolüne sahiptir.
  • Merchant API'nin etkinleştirildiği bir Google Cloud projesi, OAuth istemcisini veya API çağrılarını yetkilendiren e-postayla ilişkili hizmet hesabını barındırır.
• Geliştirici iletişim e-postası: Geliştirici iletişim e-postası da bir Google Hesabı'na bağlı olmalıdır ancak Google'dan gelen önemli hizmet duyuruları ve API güncellemeleri için birincil iletişim adresi olarak kullanılır. Bir kullanıcıya veya bir kullanıcı grubuna ait olabilir. Varsayılan olarak Merchant Center'da API developer rolünü alır.

Geliştirici iletişim e-posta adresine gönderilen daveti kabul etmem gerekir mi?

Evet. Sağladığınız geliştirici iletişim e-posta adresinin alıcısı, daveti 14 gün içinde kabul etmelidir. Kayıt işlemi yalnızca daveti kabul ettikten sonra tamamlanır. Ancak bu süre zarfında API çağrıları yapabilirsiniz.

Davet, belirtilen süre içinde kabul edilmezse davet bağlantısının süresi dolar. Artık Merchant API çağrıları yapamazsınız ve kayıt sürecini yeniden başlatmanız gerekir.

Geliştirici kaydım neden "test hesabı" hatasıyla başarısız oluyor?

Geliştirici kaydı, entegrasyonun kararlılığını sağlamak için üretim (canlı) hesaplarıyla sınırlıdır. Merchant Center'da "test hesabı" olarak işaretlenmiş, özellikle test için oluşturulmuş bir hesap kullanıyorsanız kayıt reddedilir.

Bir müşteri için yönettiğim alt hesabı kaydedebilir miyim?

İşletmenizin kimliğini temsil eden hesabı kaydetmenizi önemle tavsiye ederiz. Müşterinin alt hesabını kaydetmek yasaktır ve hatalara yol açabilir. Müşteri hizmetinizden ayrılırsa veya hesabı silerse API entegrasyonunuzun tamamı devre dışı bırakılabilir.

Web sitem için hak talebinde bulunulması mı yoksa yalnızca doğrulanması mı gerekiyor?

Geliştirici kaydı için web sitesi doğrulanmış olmalıdır. Bu, hesapla ilişkili site üzerinde yönetim kontrolünüz olduğunu kanıtlar. Alışveriş reklamları gibi diğer özellikler için hak talebinde bulunmak gerekirken API kaydı için öncelikli koşul doğrulamadır.

Hesap ve Proje Yönetimi

Hesap ve proje yönetimiyle ilgili sık sorulan sorular:

Birden fazla Merchant Center hesabı ile çalışıyorum. Merchant API ile kullanmak istediğim her Merchant Center hesabını kaydetmem gerekir mi?

Hayır. Üçüncü taraf geliştiriciyseniz veya birden fazla satıcının hesabını yöneten bir ajanssanız Google Cloud projenizi her bir satıcının hesabıyla değil, kendi birincil Merchant Center hesabınızla kaydedersiniz. Bu şekilde, satıcılarınız için yaptığınız tüm API çalışmalarında geliştiriciyi temsil edersiniz.

Birden fazla Merchant Center hesabı ile çalışıyorum. Birincil Merchant Center hesabımı nasıl seçerim?

Kullanılacak ana hesabı seçme işlemi, işletmenizin türüne bağlıdır:

• Mevcut bir gelişmiş hesabı olan pazar yerleri: İşletmeniz bir pazar yeri olarak faaliyet gösteriyorsa ve platformun tamamını temsil eden bir gelişmiş hesabı varsa bu mevcut hesap kimliğini birincil Merchant Center hesabı olarak kullanın.
• Karşılaştırmalı Alışveriş Hizmetleri (CSS): CSS iseniz benzersiz CSS hesap kimliğinizi veya CSS grubu hesap kimliğinizi kullanın.
• Ajanslar, geliştiriciler ve diğer 3. taraflar: Birden fazla satıcı hesabını yöneten ve işletmenizi temsil eden tek bir Merchant Center Kimliğine sahip olmayan bir 3. taraf işletmesi (ör. ajans veya üçüncü taraf geliştirici)yseniz yeni bir birincil Merchant Center hesabı oluşturmalı ve bu hesabın gelişmiş hesaba dönüştürülmesini istemelisiniz.

Google Cloud projeniz birincil Merchant Center hesabınıza kaydedildikten sonra, erişiminiz olan diğer Merchant Center hesaplarını tek tek kaydetmenize gerek kalmadan yönetmek için aynı projeyi kullanabilirsiniz.

Birden fazla Google Cloud projesi kullanıyorum. Her birini kaydetmem gerekiyor mu?

Evet. Kayıt işlemi, çağrı yapan Google Cloud projesini bağladığından registerGcp çağrısını, API çağrıları yapmak için kullandığınız her Google Cloud projesinden yapmanız gerekir.

Tek bir Google Cloud projesi, aynı anda yalnızca bir Merchant Center hesabına kaydedilebilir. Ancak tek bir Merchant Center hesabına birden fazla Google Cloud projesi kaydedilebilir. Benzer şekilde, birden fazla Google Cloud projesi veya birden fazla Merchant Center'da birden fazla kayıt işlemi gerçekleştirmek için aynı geliştirici e-posta adresini kullanabilirsiniz.

Bir Google Cloud projesini birden fazla Merchant Center hesabıyla kaydedersem ne olur?

Başka bir Merchant Center hesabına zaten kayıtlı olan bir Google Cloud projesini kaydetmeye çalışmak ALREADY_REGISTERED hatasına neden olur.

Geliştirici kaydı API çağrısının kimliğini nasıl doğrularım?

Merchant API için geliştirici kaydı API çağrısının kimliğini doğrulamak üzere Google Cloud projesi üzerinden yönetilen kimlik bilgilerini kullanırsınız. Kimlik doğrulama işlemini gerçekleştiren kimlik için iki temel seçeneğiniz vardır:

• OAuth 2.0 kullanan Gmail gibi bir Google Hesabı: Bu yöntemde, Google Cloud projenizde oluşturulan OAuth 2.0 istemci kimlik bilgileri kullanılır. API çağrısı, kullanıcının oturum açtığı belirli bir Google Hesabı adına yetkilendirilir.
• Hizmet Hesabı: Bu yöntemde, uygulamalar için tasarlanmış özel bir Google Hesabı türü olan Google Cloud Hizmet Hesabı kullanılır. Hizmet hesabının kimlik bilgileri de Google Cloud projenizde yönetilir.

Geliştirici kaydının başarılı olması için kimlik doğrulayan kimliğin (Google Hesabı veya hizmet hesabı) Merchant Center'da aşağıdaki kriterleri karşılaması gerekir:

• Merchant Center'da kullanıcı olarak mevcut: Kimlik doğrulama için kullanılan Google Hesabı veya hizmet hesabıyla ilişkili e-posta adresi, kayıt yaptırdığınız Merchant Center hesabına kullanıcı olarak eklenmelidir.
• Yönetici Rolü Gerekli: Bu kullanıcıya, söz konusu Merchant Center hesabında ADMIN rolü atanmış olmalıdır.

API çağrıları yapılırken:

• Doğrudan API çağrıları kullanıyorsanız Authorization üstbilgisinde geçerli bir erişim jetonu alıp sağlamanız gerekir. Bu jeton, Google Hesabı için OAuth 2.0 akışı veya hizmet hesabı için sunucudan sunucuya kimlik doğrulama akışı tarafından oluşturulur.
• Google tarafından sağlanan istemci kitaplıkları, yapılandırmalarının bir parçası olarak genellikle sizin için erişim jetonlarını alma ve yenileme işlemlerinin karmaşıklığını ele alır.

Kimliği doğrulanan kullanıcı, geliştirici iletişim kullanıcısıyla aynı olmayabilir. Daha fazla bilgi için Kimlik doğrulama e-postası ile geliştirici iletişim e-postası arasındaki fark nedir? başlıklı makaleyi inceleyin.

Erişim jetonlarını ne sıklıkta yenilemem gerekir?

Hem hizmet hesapları hem de OAuth 2.0 için erişim jetonlarının geçerlilik süresi genellikle 1 saattir. Ancak yeni bir kod alma mekanizması, kullandığınız kimlik doğrulama yöntemine bağlıdır:

• Hizmet hesapları, gerektiğinde yeni bir erişim jetonu oluşturmak için özel anahtar veya ortam kimlik bilgileri kullanır.
• OAuth 2.0 akışları, Google OAuth2 jeton uç noktasını çağırarak 1 saatlik yeni bir erişim jetonu almak için refresh_token kullanır.

Bu rotasyonu otomatik olarak işleyen resmi Google Auth kitaplıklarını kullanmanızı önemle tavsiye ederiz. Böylece uygulamanız hiçbir zaman kapalı kalmaz.

Kullanıcılar ve roller

Kullanıcılar ve roller hakkında sık sorulan sorular:

Geliştirici e-posta hesabı Merchant Center'da mevcut olmalı mı?

Hayır. Kayıt e-posta hesabı Merchant Center'da mevcut değilse Merchant API, Merchant Center'da belirtilen e-posta adresiyle bekliyor durumunda bir hesap oluşturur. Geliştirici e-posta adresi, Merchant Center hesabında mevcut bir kullanıcıya aitse bu kullanıcıya otomatik olarak API developer rolü verilir.

Geliştirici iletişim e-posta adresinin Merchant Center'da yönetici haklarına sahip olması gerekir mi?

Hayır. Geliştirici iletişim e-postasıyla ilişkili Merchant Center kullanıcısı, önemli bildirimleri almak için gereken API developer rolünü varsayılan olarak alır. Ancak Merchant Center'da minimum izinlere sahiptir. Bu kullanıcının başka API çağrıları yapmasına veya Merchant Center kullanıcı arayüzünde ayarları yönetmesine izin vermek için kullanıcıya STANDARD veya ADMIN gibi ek roller vermeniz gerekir. Merchant Center rolleri hakkında daha fazla bilgi için Erişim türleri başlıklı makaleyi inceleyin.

"API developer" rolü hangi izinlere sahip?

API developer rolü, Merchant Center'da minimum haklara sahip bir roldür. Geliştirici iletişim e-posta adresini Merchant API'ye yapılan çağrıları yetkilendirmek için kullanmayı planlıyorsanız kullanıcının API çağrıları yapabilmesi için ADMIN veya STANDARD izinlerini eklemenizi öneririz.

API'yi çağıran her geliştirici kullanıcısını veya hizmet hesabını kaydetmem gerekir mi?

Hayır. Geliştirici kaydı, API çağrıları yapmak için kullanılan Google Cloud projesine bağlıdır. Tek tek kullanıcılara veya hizmet hesaplarına bağlı değildir. Bir Google Cloud projesi, birincil Merchant Center hesabınıza başarıyla kaydedildikten sonra, Merchant API çağrılarını yetkilendirmek için OAuth kimlik bilgilerini veya hizmet hesaplarını kullanarak bağlı Google Cloud projesi üzerinden yönetilen herhangi bir kimliği kullanabilirsiniz. Bunun için kimliklerin Merchant Center hesabınızda bulunması ve ADMIN rolünün atanmış olması gerekir.

İlk kayıttan sonra geliştirici iletişim e-posta adresini nasıl değiştirebilirim?

Kişileri yönetmek veya değiştirmek için standart accounts.users hizmetini kullanın ya da Merchant Center kullanıcı arayüzündeki "Erişim ve hizmetler" sayfasını kullanarak API developer rolüne sahip kullanıcıları ekleyin veya kaldırın.

Son "API developer" kullanıcısı Merchant Center hesabından kaldırılırsa ne olur?

Hizmetin anında kesintiye uğramasını önlemek için 30 günlük ek süre başlatılır. Bu süre içinde,

• Yöneticiler, e-posta yoluyla üç zorunlu hizmet duyurusu alır (genellikle engellemeden yaklaşık 30, 17 ve 4 gün önce).
• API çağrıları normal şekilde çalışmaya devam eder.
• Yeni bir API developer, ek süre sona ermeden önce eklenmezse ilişkili Google Cloud projelerinden gelen API çağrıları AUTH_GCP_NOT_REGISTERED hatasıyla engellenir.

30 günlük ek süre sona erdiğinde, ilişkili Google Cloud projelerinden gelen API çağrıları engellenir ve geçerli bir geliştirici iletişim bilgisi geri yüklenene kadar AUTH_GCP_NOT_REGISTERED hatası alınır.

Geliştirici kaydının yapıldığı Merchant Center kimliği silinirse ne olur?

Entegrasyonunuz etkin durumdayken geliştirici kaydı için kullanılan Merchant Center hesabını silmeyin. Bu hesabın silinmesi entegrasyonunuzu hemen bozar ve artık ilişkili Google Cloud projesinden API çağrıları yapamazsınız.

İlgili Merchant Center hesabını silmeniz gerekiyorsa önce unregisterGcp yöntemini çağırarak bağlantıyı güvenli bir şekilde kaldırmalı, ardından Merchant Center kimliğini silme işlemine devam etmelisiniz. Merchant API'yi kullanmaya devam etmek istiyorsanız mevcut Merchant Center kimliğinizin kaydını sildikten hemen sonra başka bir Merchant Center kimliğiyle kaydolmanız gerekir. Yalnızca bu durumda Merchant Center kimliğini silme işlemine devam edin.

Merchant Center'da neden "API developer" rolünü göremiyorum?

API developer rolü, belirli bir Merchant Center hesabı için geliştirici kaydı yapıldıktan sonra yalnızca Merchant Center kullanıcı arayüzünde görünür. Kayıtlı olmayan Merchant Center hesaplarında API developer rolü gösterilmez.

Özel Kullanım Alanları

Özel kullanım alanlarıyla ilgili sık sorulan sorular:

Birden fazla satıcı hesabı yöneten bir ajans veya üçüncü taraf geliştiriciyim. Bunu ayarlamanın en iyi yolu nedir?

Üçüncü taraf geliştiriciler ve ajanslar, kendi birincil Merchant Center hesaplarını korumalı ve tüm Google Cloud projelerini tek bir merkezi hesaba kaydetmelidir. Google Cloud projenizi her bir satıcının hesabıyla ayrı ayrı kaydetmeyin.

Google Apps Komut Dosyaları için kayıt nasıl yapılır?

Apps Komut Dosyaları genellikle varsayılan bir Google Cloud projesinde çalışır. Bu varsayılan Google Cloud kimliğini Merchant Center hesabınıza kaydetmeniz gerekir. Google Cloud kimliği, API tarafından otomatik olarak alındığı için parametre olarak sağlamanız gerekmez.

Bir Merchant Center kimliğinin belirli bir Google Cloud proje kimliğine kayıtlı olup olmadığını kontrol edebilir miyim?

Evet. getAccountForGcpRegistration yöntemini kullanarak belirli bir Google Cloud projesine hangi Merchant Center kimliğinin kaydedildiğini kontrol edebilirsiniz. Google Cloud proje bağlantısını Merchant Center hesabınızdan kaldırmak için unregisterGcp yöntemini kullanın.

Shopify'daki Google & YouTube uygulaması kullanıcıları için Content API'den Merchant API'ye geçiş

Üçüncü taraf platformları ve uygulamaları için Content API'den Merchant API'ye geçiş hakkında sık sorulan sorular:

Content API'den Merchant API'ye geçiş yapmak için herhangi bir işlem yapmam gerekiyor mu?

Herhangi bir işlem yapmanız gerekmez. Merchant Center feed'lerinizi yönetmek için Shopify'da Google & YouTube uygulamasını kullanıyorsanız Content API'den Merchant API'ye geçiş işlemi Google tarafından gerçekleştirilir.

Geçiş işlemi ürün kimliklerimi değiştirir mi?

Hayır, geçiş işlemi Merchant Center feed'lerinizdeki ürün kimliklerini değiştirmez.

Geçişi tamamlamak için Shopify'daki Google & YouTube uygulamasını yeniden yüklemem gerekir mi?

Geçişi tamamlamak için herhangi bir işlem yapmanız gerekmez. Google & YouTube uygulamasını yeniden yüklemeniz gerekmez.

Neden Merchant Center'da Content API veri kaynaklarını görmeye devam ediyorum?

Merchant API'ye geçiş sırasında Content API veri kaynakları Merchant Center'da görünmeye devam edebilir. Bu durumlar normaldir ve herhangi bir işlem yapmanıza gerek yoktur.