Hesap durumu

Merchant API'nin beta sürümünü tanıtmak istiyoruz. Bu, Content API'nin yeni sürümüdür ve gelecekte özeldir.

Merchant Center hesabınızın, MCA'ların (çok müşterili hesap) ve bununla ilişkili tüm alt hesapların durumunu görmek için accountstatuses kaynağını kullanabilirsiniz.

Ayrı web sitelerinde satılan birden fazla online mağazası veya markası olan satıcılar, bir MCA altında alt hesaplara sahip olmayı tercih edebilir.

Alışveriş reklamları ve ücretsiz listeleme politikalarına uymaktan satıcılar sorumludur. Google Alışveriş, bu politikaları ihlal eden içerik veya davranış tespit etmemiz durumunda bu politikaları uygulama ve uygun şekilde yanıt verme hakkını saklı tutar.

Sık karşılaşılan hesap sorunlarının ayrıntıları için Hesap sorunları referansını inceleyin.

accountstatuses.get

Tek bir satıcı hesabının hesap durumu bilgilerini görüntülemek için accountstatuses.get kullanabilirsiniz.

Hangi ürün sorunlarının döndürüldüğünü kontrol etmek için destination parametresini kullanabilirsiniz. Bir hedef belirtilmediğinde varsayılan yanıt, destination: Shopping durumlarını içerir.

merchantId öğesinin bir MCA hesap kimliği ve accountId değerinin ilgili MCA'nın alt hesabı olduğu bir örnek isteği aşağıda görebilirsiniz:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId

Bağımsız bir hesabın hesap durumu bilgilerini almak için merchantId ve accountId için aynı hesap kimliğini kullanarak accountstatuses.get numaralı telefonu arayın.

Bu yöntem, hesap ve öğe düzeyindeki sorunları döndürür. accountstatuses.get tarafından verilen yanıtta döndürülen accountLevelIssues sorununu düzeltmek için Alışveriş reklamları ve Ücretsiz listelemeler kaynaklarını kullanabilirsiniz.

Aşağıda, "açılış sayfası çalışmıyor" ihlali nedeniyle askıya alınan bir alt hesap için örnek bir yanıt verilmiştir.

{
 "kind": "content#accountStatus",
 "accountId": "123456789",
 "websiteClaimed": true,
 "accountLevelIssues": [
  {
   "id": "editorial_and_professional_standards_destination_url_down_policy",
   "title": "Account suspended due to policy violation: landing page not working",
   "country": "US",
   "severity": "critical",
   "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
  },
  {
   "id": "missing_ad_words_link",
   "title": "No Google Ads account linked",
   "severity": "error",
   "documentation": "https://support.google.com/merchants/answer/6159060"
  }
 ],
 "products": [
  {
   "channel": "online",
   "destination": "Shopping",
   "country": "US",
   "statistics": {
    "active": "0",
    "pending": "0",
    "disapproved": "5",
    "expiring": "0"
   },
   "itemLevelIssues": [
    {
     "code": "image_link_broken",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "image link",
     "description": "Invalid image [image link]",
     "detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
     "documentation": "https://support.google.com/merchants/answer/6098289",
     "numItems": "2"
    },
    {
     "code": "landing_page_error",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "link",
     "description": "Unavailable desktop landing page",
     "detail": "Update your website or landing page URL to enable access from desktop devices",
     "documentation": "https://support.google.com/merchants/answer/6098155",
     "numItems": "5"
    },
    {
     "code": "missing_condition_microdata",
     "servability": "unaffected",
     "resolution": "merchant_action",
     "description": "Missing or invalid data [condition]",
     "detail": "Add valid structured data markup to your landing page",
     "documentation": "https://support.google.com/merchants/answer/6183460",
     "numItems": "5"
    },
    {
     "code": "mobile_landing_page_error",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "link",
     "description": "Unavailable mobile landing page",
     "detail": "Update your website or landing page URL to enable access from mobile devices",
     "documentation": "https://support.google.com/merchants/answer/6098296",
     "numItems": "3"
    }
   ]
  }
 ]
}

accountstatuses.list

MCA'nızın tüm alt hesaplarındaki hesap durumu bilgilerini görüntülemek için accountstatuses.list kullanabilirsiniz.

Ürün sorunlarını hedefe göre filtrelemek için accountstatuses.list ile filtreleri kullanabilirsiniz. Bir hedef belirtilmediğinde, yanıtta destination: Shopping ile ilgili durumlar da yer alır.

Aşağıda, MCA merchantId kapsamındaki tüm alt hesaplar için hesap durumu bilgilerini almayla ilgili örnek bir istek yer almaktadır:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses

Aşağıda örnek bir yanıt verilmiştir:

{
 "kind": "content#accountstatusesListResponse",
 "resources": [
  {
   "kind": "content#accountStatus",
   "accountId": "1234567",
   "websiteClaimed": true,
   "accountLevelIssues": [
    {
     "id": "editorial_and_professional_standards_destination_url_down_policy",
     "title": "Account suspended due to policy violation: landing page not working",
     "country": "US",
     "severity": "critical",
     "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
    },
    {
     "id": "missing_ad_words_link",
     "title": "No Google Ads account linked",
     "severity": "error",
     "documentation": "https://support.google.com/merchants/answer/6159060"
    }
   ],
   "products": [
    {
     "channel": "online",
     "destination": "Shopping",
     "country": "US",
     "statistics": {
      "active": "0",
      "pending": "0",
      "disapproved": "0",
      "expiring": "0"
     }
    }
   ]
  },
  {
   "kind": "content#accountStatus",
   "accountId": "123456789",
   "websiteClaimed": true,
   "accountLevelIssues": [
    {
     "id": "home_page_issue",
     "title": "Website URL not provided",
     "severity": "critical",
     "documentation": "https://support.google.com/merchants/answer/176793"
    },
    {
     "id": "missing_ad_words_link",
     "title": "No Google Ads account linked",
     "severity": "error",
     "documentation": "https://support.google.com/merchants/answer/6159060"
    }
   ],
   "products": [
    {
     "channel": "online",
     "destination": "Shopping",
     "country": "US",
     "statistics": {
      "active": "0",
      "pending": "0",
      "disapproved": "0",
      "expiring": "0"
     }
    }
   ]
  }
 ]
}

MCA olmayan bir hesap (ör. bağımsız bir Merchant Center hesabı) için accountstatuses.list öğesine yapılan çağrı, 403 hatası döndürür.

Aşağıda, bağımsız bir hesap için accountstatuses.list çağrısına ilişkin örnek bir yanıt verilmiştir:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "forbidden",
    "message": "111111111 is not a multi-client account (MCA). The only account
                service operations allowed on non-MCAs are 'get', 'update',
                'authinfo' and 'claimwebsite'."
   }
  ],
  "code": 403,
  "message": "111111111 is not a multi-client account (MCA). The only account
              service operations allowed on non-MCAs are 'get', 'update',
              'authinfo' and 'claimwebsite'."
 }
}

Toplu mod

GET yönteminin kullanıldığı bir accountstatuses.custombatch, çok müşterili bir hesaptaki birden çok alt hesabın hesap durumu bilgilerini döndürür.

JSON isteği; MCA hesap numarasının merchantId, alt hesabın accountId, benzersiz bir batchId ve get olarak ayarlanmış method değerini içerir.

POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch

Aşağıda örnek bir istek JSON gövdesi verilmiştir:

{
  "entries": [
    {
      "accountId": 1212121212,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 9
    },
    {
      "accountId": 1313131313,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 99
    }
  ]
}

Aşağıda örnek bir JSON yanıt gövdesi verilmiştir:

{
 "kind": "content#accountstatusesCustomBatchResponse",
 "entries": [
  {
   "batchId": 9,
   "accountStatus": {
    "kind": "content#accountStatus",
    "accountId": "1212121212",
    "websiteClaimed": true,
    "accountLevelIssues": [
     {
      "id": "home_page_issue",
      "title": "Website URL not provided",
      "severity": "critical",
      "documentation": "https://support.google.com/merchants/answer/176793"
     },
     {
      "id": "missing_ad_words_link",
      "title": "No Google Ads account linked",
      "severity": "error",
      "documentation": "https://support.google.com/merchants/answer/6159060"
     }
    ],
    "products": [
     {
      "channel": "online",
      "destination": "Shopping",
      "country": "US",
      "statistics": {
       "active": "0",
       "pending": "0",
       "disapproved": "0",
       "expiring": "0"
      }
     }
    ]
   }
  },
  {
   "batchId": 99,
   "accountStatus": {
    "kind": "content#accountStatus",
    "accountId": "1313131313",
    "websiteClaimed": true,
    "accountLevelIssues": [
     {
      "id": "editorial_and_professional_standards_destination_url_down_policy",
      "title": "Account suspended due to policy violation: landing page not working",
      "country": "US",
      "severity": "critical",
      "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
     },
     {
      "id": "missing_ad_words_link",
      "title": "No Google Ads account linked",
      "severity": "error",
      "documentation": "https://support.google.com/merchants/answer/6159060"
     }
    ],
    "products": [
     {
      "channel": "online",
      "destination": "Shopping",
      "country": "US",
      "statistics": {
       "active": "0",
       "pending": "0",
       "disapproved": "0",
       "expiring": "0"
      }
     }
    ]
   }
  }
 ]
}

Hesap Durumları kaynağını test etme

Aşağıdaki örnekte MCA hesapları için hesap durumu gösteriliyor, listeleniyor ve custombatch.get:

1. accountstatuses.get kullanarak bir MCA için alt hesap durumunu öğrenin.

   1. API uç noktasına yönelik bir GET işlemi gerçekleştirerek merchantId ve accountId bilgilerini alın:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
      

   2. Başarı için HTTP 200 durum kodu ve JSON biçiminde hesap durumu listesi alırsınız.

2. accountstatuses.list kullanarak bir MCA için tüm alt hesap durumunu görüntüleyin.

   1. merchantId cihazınızla API uç noktasına bir GET işlemi gerçekleştirin:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
      

   2. Başarılı için HTTP 200 durum kodu ve gönderilen merchantId için JSON biçiminde hesap durumu listesi alacaksınız.

3. accountstatuses.custombatch kullanarak MCA için birden fazla alt hesabı toplu modda görüntüleyin.

   1. accountID, merchant ID ve bir get yöntemini kullanarak geçerli JSON oluşturun.

   2. API uç noktasına bir POST işlemi gerçekleştirin:

      POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
      

   3. Başarı için HTTP 200 durum kodu ve JSON biçiminde hesap durumu listesi alırsınız.