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

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

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

قبل از شروع

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

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

لیست همه حساب ها

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

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

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

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

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

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

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

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

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

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

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

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

محدودیت ها

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