Merchant API'de test hesapları

Merchant API Test Hesapları özelliği, entegrasyonları canlı bir ortamda dağıtmadan önce kapsamlı bir şekilde test etmek için güvenli ve izole bir alan sağlar. Sandbox'a alınmış test hesaplarını kullanarak API çağrılarıyla denemeler yapabilir, kodu doğrulayabilir ve geliştirme döngüsünün başlarında olası sorunları belirleyebilirsiniz. Bu sayede üretim verilerini etkilemez, gerçek zamanlı işlemleri kesintiye uğratmaz veya Merchant Center politikalarını istemeden ihlal etmezsiniz.

Ön koşullar

Test hesapları oluşturup kullanabilmeniz için aşağıdaki koşulları karşıladığınızdan emin olun:

  • Merchant Center hesabı: Merchant Center hesabınız olmalıdır.
  • Merchant API erişimi: Merchant API'nin kayıtlı kullanıcısı olmanız gerekir.

Test hesaplarının avantajları

Test hesaplarını kullanmanın başlıca avantajları şunlardır:

  • Basit Kurulum: Test hesabı kurulumu, özelliklerinizi ve entegrasyonlarınızı hızlı bir şekilde test etmeye başlamanıza olanak tanıyan, düşük karmaşıklıkta bir süreçtir.
  • Veri Bütünlüğü ve Güvenliği: Üretim verileri korunmaya devam eder ve üretim hesaplarındaki politika ihlali riski ortadan kalkar.
  • Test Verimliliği: Test amacıyla paralel bir üretim hesabı tutma yükü olmadan çok çeşitli senaryoları ve uç durumları test edebilirsiniz.
  • Anında Fırsat Doğrulaması: Fırsat eklemelerini hızlıca test etmek için test hesaplarında ana sayfa talebi ve doğrulamasından otomatik muafiyetten yararlanın. Teklifler, test hesapları için varsayılan olarak onaylanır.
  • Gerçekçi Simülasyon: Ortam, ürün yükleme ve envanter yönetimi gibi kritik işlevler için üretim davranışını yansıtır ve test sonuçlarının güvenilir olmasını sağlar.
  • Daha sorunsuz API geçişleri: Test hesapları, yan yana doğrulama olanağı sunarak Content API'den Merchant API'ye veya bir API sürümünden diğerine geçiş yapan kullanıcılar için güvenli ve sorunsuz bir geçiş sağlar.

Test hesabı oluşturma

Test hesapları, Merchant API'deki belirli bir özel yöntem kullanılarak oluşturulur.

accounts.createTestAccount yöntemini kullanın:

  POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
  Content-Type: application/json
  Authorization: Bearer {ACCESS_TOKEN}"

  {
    "account_name": "{TEST_ACCOUNT_NAME}",
    "time_zone": {
      "id": "America/Los_Angeles"
    },
    "language_code": "en-US"
  }

Aşağıdakileri değiştirin:

  • ACCOUNT_ID: Merchant Center kimliğiniz.
  • ACCESS_TOKEN: API çağrısı yapmak için kullanılan yetkilendirme jetonu
  • TEST_ACCOUNT_NAME: Test hesabının adı. Test için kullanıldıklarını belirten anlamlı adlar kullanmanızı öneririz. Örneğin, test hesabı adında test kelimesi yer almalıdır.

Test hesabı oluştururken aşağıdaki alanlar gereklidir:

  • time_zone: Hesabın raporlama ve görüntüleme saat dilimi.
  • language_code: Hesabın BCP-47 dil kodu (ör. en-US).

Başarılı bir çağrı, yeni test hesabının benzersiz accountId ve kaynak adını içeren bir Hesap kaynağı döndürür:

  {
    "name": "accounts/{TEST_ACCOUNT_ID}",
    "accountId": "{TEST_ACCOUNT_ID}",
    "accountName": "{TEST_ACCOUNT_NAME}",
    "adultContent": false,
    "testAccount": true,
    "timeZone": {
      "id": "America/Los_Angeles"
    },
    "languageCode": "en-US"
  }

Sınırlamalar

Test hesapları, işlevsel doğrulama için tasarlanmıştır ve belirli kısıtlamalara tabidir:

  • Test hesabı sayısı: Google Hesabı başına en fazla 5 test hesabı oluşturabilirsiniz. Test hesapları, Google Hesabı başına Merchant Center hesabı için varsayılan sınırınıza dahil edilir.
  • Merchant API kotalarıyla entegrasyon: API kotası açısından Merchant API, test hesaplarını üretim hesapları olarak değerlendirir. Test hesapları, üretim hesaplarıyla aynı kotalara tabidir. Test hesapları için kota artışı yapılamaz.
  • Gelişmiş hesaplar: Gelişmiş test hesapları oluşturamaz veya gelişmiş bir hesabı test hesabına dönüştüremezsiniz.
  • Herkese açık yayın yok: Bir test hesabına gönderilen veriler hiçbir zaman Arama veya Alışveriş reklamları gibi bir Google platformunda yayınlanmaz.
  • Kısıtlanmış uç noktalar: Aşağıdaki gibi belirli özellikleri kullanırken test hesaplarını kullanamazsınız:
  • Bağlantı Kısıtlamaları: Test hesaplarını diğer Google Ads veya Google İşletme Profili hesaplarına bağlayamazsınız.
  • Test hesapları için kayıt yok: Test hesapları için kayıt işlemi yapamazsınız.

En İyi Uygulamalar

Test hesaplarını kullanırken bazı en iyi uygulamalara uymanızı öneririz:

  • Önce Korumalı Alan Geliştirme: Yeni entegrasyon özelliklerini üretim ortamınıza uygulamadan önce her zaman bir test hesabında doğrulayın.
  • Otomatik Entegrasyon Testi: Otomatik regresyon testlerini çalıştırmak için test hesaplarını kararlı ortamlar olarak kullanın.
  • Test hesabı adlandırma: Her test hesabının amacını belirtmek için account_name simgesini kullanın. Örneğin, "Taşıma testi" veya "Entegrasyon testi hesabı".