وضعیت حساب

شما می‌توانید از منبع accountstatuses برای مشاهده وضعیت حساب مرکز فروش خود یا یک حساب چند مشتریه (MCA) و تمام حساب‌های فرعی مرتبط با آن استفاده کنید.

فروشندگانی که چندین فروشگاه آنلاین یا برندهایی دارند که در وب‌سایت‌های جداگانه فروخته می‌شوند، می‌توانند حساب‌های فرعی تحت MCA داشته باشند.

فروشندگان مسئول رعایت سیاست‌های تبلیغات خرید و فهرست‌های رایگان هستند. گوگل شاپینگ حق دارد در صورت مشاهده محتوا یا رفتاری که این سیاست‌ها را نقض می‌کند، این سیاست‌ها را اجرا کرده و به طور مناسب پاسخ دهد.

برای جزئیات مربوط به مشکلات رایج حساب، به مرجع مشکلات حساب مراجعه کنید.

وضعیت حساب.دریافت

شما می‌توانید accountstatuses.get برای مشاهده اطلاعات وضعیت حساب یک حساب تجاری واحد استفاده کنید.

شما می‌توانید از پارامتر destination برای کنترل اینکه کدام مشکلات محصول بازگردانده شوند استفاده کنید. وقتی مقصدی مشخص نشده باشد، پاسخ پیش‌فرض شامل وضعیت‌هایی برای destination: Shopping .

در اینجا یک درخواست نمونه آورده شده است که در آن merchantId شناسه حساب MCA و accountId زیرحساب آن MCA است:

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

برای دریافت اطلاعات وضعیت حساب برای یک حساب مستقل، تابع accountstatuses.get را با همان شناسه حساب برای merchantId و accountId فراخوانی کنید.

این متد مشکلات مربوط به سطح حساب و کالا را برمی‌گرداند. می‌توانید از منابع Shopping ads و Free listings برای رفع accountLevelIssues که در پاسخ از accountstatuses.get برگردانده شده است، استفاده کنید.

در اینجا نمونه‌ای از پاسخ برای یک حساب کاربری فرعی که به دلیل تخلف «صفحه فرود کار نمی‌کند» به حالت تعلیق درآمده است، آورده شده است.

{
 "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 خود استفاده کنید.

شما می‌توانید از فیلترهایی با تابع accountstatuses.list برای فیلتر کردن مشکلات محصول بر اساس مقصد استفاده کنید. وقتی مقصدی مشخص نشده باشد، پاسخ شامل وضعیت‌هایی برای destination: Shopping .

در اینجا یک نمونه درخواست برای دریافت اطلاعات وضعیت حساب برای همه حساب‌های فرعی تحت MCA merchantId آورده شده است:

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

در اینجا یک نمونه پاسخ آمده است:

{
 "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"
     }
    }
   ]
  }
 ]
}

فراخوانی accountstatuses.list برای یک حساب غیر MCA (مثلاً یک حساب Merchant Center مستقل) خطای 403 را برمی‌گرداند.

در اینجا یک نمونه پاسخ برای فراخوانی accountstatuses.list برای یک حساب کاربری مستقل آورده شده است:

{
 "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'."
 }
}

حالت دسته‌ای

تابع accountstatuses.custombatch به همراه متد GET ، اطلاعات وضعیت حساب را برای چندین حساب فرعی در یک حساب چند کلاینتی برمی‌گرداند.

درخواست JSON شامل merchantId شماره حساب MCA، accountId زیرحساب، یک batchId منحصر به فرد و method که برای get تنظیم شده است، می‌باشد.

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

در زیر نمونه‌ای از بدنه درخواست JSON آمده است:

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

نمونه‌ای از بدنه پاسخ JSON در زیر آمده است:

{
 "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"
      }
     }
    ]
   }
  }
 ]
}

منبع وضعیت حساب را آزمایش کنید

در مثال زیر، وضعیت حساب کاربری را برای حساب‌های MCA دریافت، فهرست و custombatch.get می‌کنیم:

  1. با استفاده از accountstatuses.get وضعیت حساب فرعی یک MCA را دریافت کنید.

    1. با انجام یک GET به نقطه پایانی API، شناسه merchantId و accountId را دریافت کنید:

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

    2. شما باید یک کد وضعیت HTTP 200 برای موفقیت و لیست وضعیت حساب در JSON دریافت کنید.

  2. مشاهده وضعیت همه حساب‌های فرعی برای یک MCA با استفاده از accountstatuses.list .

    1. با استفاده از merchantId خود، یک GET به نقطه پایانی API انجام دهید: 

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

    2. شما باید یک کد وضعیت HTTP 200 برای موفقیت و لیست وضعیت حساب در قالب JSON برای merchantId ارسال شده دریافت کنید.

  3. با استفاده از accountstatuses.custombatch چندین حساب فرعی MCA را به صورت دسته‌ای مشاهده کنید.

    1. با استفاده از accountID ، merchant ID و یک متد get یک JSON معتبر بسازید.

    2. یک POST به نقطه پایانی API انجام دهید: 

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

    3. شما باید یک کد وضعیت HTTP 200 برای موفقیت و لیست وضعیت حساب در JSON دریافت کنید.