Bu sayfada, Merchant API'yi kullanarak nasıl Merchant Center hesabı oluşturabileceğiniz ve örnek ürün yükleyebileceğiniz açıklanmaktadır.
Başlamadan önce
Google Cloud projenizde Merchant API'yi etkinleştirin.
API entegrasyonu, Alışveriş İçerik Hizmeti kullanılarak AppScript'te kullanılıyorsa varsayılan bir Google Cloud projesi oluşturur ve Merchant API hizmetini otomatik olarak etkinleştirir. Ancak Merchant API'yi kullanmadan önce tek seferlik geliştirici kaydını tamamlamanız gerekir. Daha fazla bilgi için Apps Komut Dosyası'nda Merchant API Hizmeti'ni Kullanma başlıklı makaleyi inceleyin.
Hesap oluştur
Merchant API'yi kullanmak için Merchant Center hesabınız olmalıdır. Merchant Center hesabı oluşturmak için Merchant Center'ı kullanmaya başlama başlıklı makaleyi inceleyin.
Geliştirici olarak kayıt ol
Merchant API'yi kullanmak için Merchant Center hesabınızı ve Google Cloud projenizi aşağıdaki gibi Geliştirici Kaydı yöntemini kullanarak bağlamanız gerekir:
Merchant Center ile Google Cloud projenizi bağlayın: Arayan, Google Cloud projesinden geçerli bir erişim jetonuna veya API anahtarına sahip olduğu ve Merchant Center hesabının yetkili kullanıcısı olduğu için bağlantı otomatik olarak onaylanır.
Merchant Center hesabına bir API geliştirici kullanıcısı ekleme: Registration API, Merchant Center hesabına bir API geliştirici kullanıcısı ekler. Mevcut kullanıcılara yeni erişim türü verilir. Yeni kullanıcılar Merchant Center e-posta davetiyesi alır.
Kişi kuruluşunuzdan ayrılırsa veya silinirse geçerli geliştirici kaydınızın devam etmesini sağlamak için ek veya yedek API geliştiricileri eklemek üzere accounts.users.create yöntemini kullanmanızı öneririz.
Kaydolduktan sonra GetDeveloperRegistration simgesini kullanarak kayıt durumunu görüntüleyebilir veya UnregisterGCP simgesini kullanarak kaydınızı silebilirsiniz.
Kayıt araması
POST https://merchantapi.googleapis.com/accounts/v1beta/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"]
}
}
API geliştiricisi kaydedildikten sonra, accounts.users.patch yöntemini kullanarak geliştiriciye STANDARD ve ADMIN gibi ek roller verebilirsiniz.
Hesap kimliğinizi edinme
Hesap kimliğini accounts.list yöntemini kullanarak edinebilirsiniz.
Merchant API isteklerini çalıştırmak için Google API Gezgini'ni kullanabilirsiniz. API Gezgini, kimlik doğrulama için Google OAuth 2.0'ı kullanır. İstekleri çalıştırmadan önce Google OAuth 2.0 onay kutusunun işaretli olduğundan emin olun.
OAuth 2.0 kullanarak kimlik doğrulaması yapmak için Google Hesabınızda ve ardından API'ler Gezgini'nde oturum açmanız gerekir. Ayrıca, API Gezgini'nin ürün listelemelerinizi ve hesaplarınızı yönetmesine izin vermeniz gerekir.
Aşağıdaki istekte, hesap kimliğinizi nasıl alabileceğiniz gösterilmektedir:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
veya
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}
İstek başarıyla çalıştırıldıktan sonra aşağıdaki yanıtı görürsünüz:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
Diğer istekleri çalıştırmak için ihtiyacınız olacağından {ACCOUNT_ID} simgesini kopyalayın.
Birincil ürün veri kaynağı oluşturma
Ürün eklemek için birincil ürün veri kaynağına ihtiyacınız vardır. Aşağıdaki istekte, hesabınıza ürün eklemek için kullanabileceğiniz bir veri kaynağının nasıl oluşturulacağı gösterilmektedir:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1
{
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"contentLanguage": "en",
"countries": [
"US"
],
"feedLabel": "US"
},
"name": "primary-data-source",
"displayName": "Primary Products Data Source"
}
{ACCOUNT_ID} kısmını, oluşturduğunuz Merchant Center hesabının kimliğiyle değiştirin.
Bu istek başarıyla çalıştırıldıktan sonra aşağıdaki yanıtı görürsünüz:
{
"name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
"dataSourceId": "{DATASOURCE_ID}",
"displayName": "Primary Products Data Source",
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"feedLabel": "US",
"contentLanguage": "en",
"countries": [
"US"
],
"defaultRule": {
"takeFromDataSources": [
{
"self": true
}
]
}
},
"input": "API"
}
name alanının değerini kopyalayın. Bu değeri, ürün eklemek için kullanmanız gerekir.
Oluşturulan veri kaynağının ürün eklemek için kullanılabilir hâle gelmesi birkaç dakika sürer.
Bu veri kaynağını Merchant Center kullanıcı arayüzünde görüntüleyebilirsiniz. Daha fazla bilgi için Veri kaynakları sekmesini bulma başlıklı makaleyi inceleyin.
Ürün ekle
Hesabınıza örnek bir ürün eklemek için aşağıdaki isteği çalıştırın:
POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1
{
"channel": "ONLINE",
"contentLanguage": "en",
"feedLabel": "US",
"name": "Red T-shirt",
"attributes": {
"gender": "Male",
"brand": "New brand"
},
"offerId": "tshirt-123"
}
{DATASOURCE_NAME} yerine daha önce kopyaladığınız değeri girin.
Bu istek başarıyla çalıştırıldıktan sonra aşağıdaki yanıtı görürsünüz:
{
"name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
"product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
"channel": "ONLINE",
"offerId": "tshirt-123",
"contentLanguage": "en",
"feedLabel": "US",
"attributes": {
"brand": "New brand",
"gender": "Male"
}
}
Yeni oluşturulan ürünün ürün kimliği online~en~US~tshirt-123. Bu ürünle ilgili ayrıntıları almak için accounts.products.get yöntemini kullanabilirsiniz. Bu ürünü görüntülemek için Merchant Center kullanıcı arayüzünü de kullanabilirsiniz.