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.
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.
Hesap kimliğinizi alma
accounts.list yöntemini kullanarak hesap kimliğini edinebilirsiniz.
Merchant API isteklerini çalıştırmak için Google API Gezgini'ni kullanabilirsiniz. APIs Explorer, 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 oturum açmanız ve ardından APIs Explorer'da 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 istek, hesap kimliğinizi nasıl alabileceğinizi gösterir:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
İ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 {ACCOUNT_ID} değerini kopyalayın.
Birincil ürün veri kaynağı oluşturma
Ürün eklemek için birincil bir ürün veri kaynağına ihtiyacınız vardır. Aşağıdaki istek, hesabınıza ürün eklemek için kullanabileceğiniz bir veri kaynağının nasıl oluşturulacağını gösterir:
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"
}
Ürün eklemek için name alanının değerini kopyalayın.
Oluşturulan veri kaynağının ürün eklemek için kullanılabilir hale 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} değerini daha önce kopyaladığınız değerle 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}/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.