با داده های حساب کار کنید

این آموزش به شما نحوه کار با داده‌های حساب را نشان می‌دهد. API مدیریت حساب My Business به شما امکان انجام موارد زیر را می‌دهد:

• همه حساب‌ها را فهرست کنید.
• یک حساب کاربری خاص را برگردانید.
• به‌روزرسانی یک حساب کاربری.

قبل از اینکه شروع کنی

قبل از استفاده از API مدیریت حساب کاربری My Business، باید برنامه خود را ثبت کنید و اعتبارنامه‌های OAuth 2.0 را دریافت کنید.

برای جزئیات بیشتر در مورد نحوه شروع به کار با APIهای پروفایل تجاری، به تنظیمات اولیه مراجعه کنید.

فهرست کردن همه حساب‌ها

یک راه عالی برای اعتبارسنجی حساب‌های کاربری مرتبط با یک کاربر احراز هویت شده، فهرست کردن تمام حساب‌های کاربری اوست. از API accounts.list برای فهرست کردن تمام حساب‌های کاربری مرتبط با یک کاربر استفاده کنید.

برای فهرست کردن تمام حساب‌های کاربری یک کاربر احراز هویت شده، از دستور زیر استفاده کنید:

اچ‌تی‌پی

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

بازگرداندن یک حساب کاربری خاص

گاهی اوقات، فقط می‌خواهید اطلاعات مربوط به یک حساب کاربری خاص را برای یک کاربر احراز هویت شده مشاهده کنید. از API accounts.get برای بازگرداندن یک حساب کاربری خاص و بررسی جزئیات بیشتر حساب کاربری استفاده کنید.

برای برگرداندن یک حساب کاربری خاص بر اساس نام، از موارد زیر استفاده کنید:

اچ‌تی‌پی

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

به‌روزرسانی حساب کاربری

تغییر نام حساب کاربری یک کار مدیریتی اساسی است. از API accounts.update برای تغییر نام حساب کاربری استفاده کنید.

برای به‌روزرسانی یک حساب کاربری خاص بر اساس نام، از موارد زیر استفاده کنید:

اچ‌تی‌پی

$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

{
  "account": {
    "accountName": "Anne Droyd"
  },
  "languageCode": "en",
  "validateOnly": "true"
}

محدودیت‌ها

• تنها فیلد قابل ویرایش برای یک حساب کاربری، accountName است. هر فیلد دیگری که ارسال شود، نادیده گرفته می‌شود.
• فقط حساب‌های نوع BUSINESS می‌توانند به این روش به‌روزرسانی شوند.