Karşılaştırmalı Alışveriş Hizmetleri'ni (CSS) kullanmaya başlama

API ile temel işlemleri gerçekleştirmek, API'yi kullanmaya başlamak için iyi bir yöntemdir.

Ön koşullar

Başlamadan önce aşağıdakileri tamamlayın:

  • Geçerli bir CSS Center hesabınız olduğundan emin olun.
  • API geliştiricisi kaydetme
  • İzin ayarlarınızın doğruluğunu kontrol edin.
  • CSS API'yi etkinleştirdiğinizi doğrulayın.
  • Ortamınız için istemci kitaplıklarını yüklediğinizi doğrulayın.

Daha fazla bilgi için Hızlı Başlangıç bölümüne bakın.

CSS API'yi etkinleştirme

CSS API'yi kullanmak için geliştirici olarak kaydolmanız gerekir. CSS Center hesabınızı ve Google Cloud projenizi, aşağıdaki gibi Geliştirici Kaydı yöntemini kullanarak bağlamanız gerekir:

CSS Center ile Google Cloud projenizi bağlayın: Arayan, erişim jetonu veya API anahtarına göre Google Cloud projesine erişebildiği ve CSS Center hesabının yetkili kullanıcısı olduğu için bağlantı otomatik olarak oluşturulur.

API geliştiricisi kaydetme

CSS Center hesabına bir API geliştirici kullanıcısı ekleme: Kullanıcı zaten varsa yalnızca yeni "API Geliştirici" erişim türü verilir. Yeni kullanıcılar CSS Center e-posta daveti alır.

Kaydolduktan sonra GetDeveloperRegistration simgesini kullanarak kayıt durumunu görüntüleyebilir veya UnregisterGCP simgesini kullanarak kaydı silebilirsiniz. Aşağıdaki kayıt çağrısını kullanabilirsiniz:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

İstek başarıyla çalıştırıldıktan sonra şu yanıtı alırsınız:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

CSS ürünleri

CSS API, Ürünler alt API'sine benzer şekilde CssProductInput ile ListCssProduct arasında ayrım yapar. InsertCssProductInput ile ürün ekleyin.

Dahili sistemlerimiz ürünü işledikten sonra (bu işlem birkaç dakika sürebilir) ListCssProducts ile alın.

raw_provided_id kullanarak ürünlerinizi tanımlayın. Kendi sisteminizde kullandığınız bir tanımlayıcıyı kullanmanızı öneririz. Alternatif olarak, bu tür bir belge oluşturmak için aşağıdaki yöntemlerden biri kullanılabilir:

  • Genel Olarak Benzersiz Tanımlayıcılar (GUID'ler)
  • Evrensel Olarak Benzersiz Tanımlayıcılar (UUID'ler)
  • Birleştirilmiş benzersiz ürün özellikleri (ör. marka_model_renk_beden)

Daha fazla bilgi için Ürün ekleme/listeleme/güncelleme/silme başlıklı makaleyi inceleyin.

Temel işlemler

Deneyebileceğiniz bazı temel istekleri aşağıda bulabilirsiniz.

  1. InsertCssProductInput simgesini kullanarak bir test ürünü ekleyin. Gönderilecek özelliklerle ilgili yardım için bu örnek kodu inceleyin.

  2. ListCssProducts kullanarak tüm ürünlerinizi listeleyin. Bir ürünün eklenmesiyle listelemede görünmesi arasında kısa bir işleme gecikmesi olduğunu unutmayın. Hemen görmezseniz birkaç saniye sonra tekrar deneyin.

  3. UpdateCssProductInput kullanarak tek bir ürünü güncelleyin cssproductinput.name kullanarak. Yalnızca güncellenmesi gereken özellikleri göndermeniz gerekir. Örnek için örnek koda bakın.

  4. DeleteCssProductInpu kullanarak test ürününü silin ve raw_provided_id değerini girin.

Sınırlamalar

Tek bir ürün ekleme veya silme işlemi yavaş olabilir. Performansı artırmak için: Performansı artırmak için Async'i kullanın. Bu, API'nin paralel olarak çağrılmasını sağlar.

Hesaplarınızı listeleme ve etiketleme

CSS API'deki etiket yönetimi, özel etiketler kullanarak müşteri Merchant Center hesaplarınızı programatik olarak düzenlemenize olanak tanır. Bu özellik, müşterileri verimli bir şekilde (ör. türe veya stratejiye göre) kategorize etmenize yardımcı olarak daha iyi bir organizasyon ve kolaylaştırılmış işlemler sağlar. API'yi kullanarak etiketlerde aşağıdaki işlevleri gerçekleştirebilirsiniz: