Method: customers.profiles.list

نمایه‌های مرورگر Chrome یک مشتری را بر اساس معیارهای جستجو و مرتب‌سازی داده شده فهرست می‌کند.

درخواست HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/profiles

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
parent

string

مورد نیاز. قالب: مشتریان/{customer_id}

پارامترهای پرس و جو

پارامترها
page Size

integer

اختیاری. حداکثر تعداد پروفایل برای بازگشت. اگر اندازه صفحه مشخص نشده باشد، اندازه صفحه پیش‌فرض 100 است و حداکثر اندازه صفحه مجاز 200 است.

page Token

string

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

filter

string

اختیاری. فیلتری که برای فیلتر کردن پروفایل ها استفاده می شود. فیلدهای زیر را می توان در فیلتر استفاده کرد:

  • شناسه پروفایل
  • نمایش نام
  • ایمیل کاربر
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • اولین زمان ثبت نام
  • osPlatformType
  • osVersion
  • مرورگر نسخه
  • مرورگر کانال
  • شمارش سیاست
  • extensionCount
  • هویت ارائه دهنده
  • وابستگی دولت
  • ouId

هر یک از فیلدهای بالا را می توان برای تعیین یک فیلتر استفاده کرد و فیلتر کردن توسط چندین فیلد با عملگر AND پشتیبانی می شود. فیلدهای نوع رشته و فیلدهای نوع enum از عملگرهای '=' و '!=' پشتیبانی می کنند. فیلدهای نوع عدد صحیح و نوع مهر زمانی از عملگرهای '='، '!='، '<'، '>'، '<=' و '>=' پشتیبانی می کنند. مُهرهای زمانی انتظار یک رشته با قالب RFC-3339 را دارند (مثلاً 2012-04-21T11:30:00-04:00). علامت عام '*' را می توان با فیلتر فیلد نوع رشته ای استفاده کرد. به‌علاوه، از فیلتر کردن رشته‌ای نیز پشتیبانی می‌شود، به‌عنوان مثال، «ABC» به‌عنوان یک فیلتر به فیلتری نگاشت می‌شود که بررسی می‌کند آیا هر یک از فیلدهای نوع رشته قابل فیلتر حاوی «ABC» است یا خیر.

شماره واحد سازمان را می توان به عنوان معیار فیلتر در اینجا با تعیین 'ouId = ${your_org_unit_id}' استفاده کرد، لطفاً توجه داشته باشید که تنها تطبیق شناسه OU واحد پشتیبانی می شود.

order By

string

اختیاری. فیلدهایی که برای تعیین ترتیب نتایج استفاده می شوند. فیلدهای پشتیبانی شده عبارتند از:

  • شناسه پروفایل
  • نمایش نام
  • ایمیل کاربر
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • اولین زمان ثبت نام
  • osPlatformType
  • osVersion
  • مرورگر نسخه
  • مرورگر کانال
  • شمارش سیاست
  • extensionCount
  • هویت ارائه دهنده
  • وابستگی دولت

به طور پیش‌فرض، مرتب‌سازی به ترتیب صعودی است، برای تعیین ترتیب نزولی برای یک فیلد، پسوند "desc" باید به نام فیلد اضافه شود. ترتیب پیش‌فرض ترتیب نزولی lastStatusReportTime است.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ به روش profiles.list.

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

نمایندگی JSON 
{
  "chromeBrowserProfiles": [
    {
      object (ChromeBrowserProfile)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
فیلدها
chrome Browser Profiles[]

object ( ChromeBrowserProfile )

لیست نمایه ها برگردانده شد.

next Page Token

string

نشانه صفحه بندی که می تواند برای فهرست کردن صفحه بعدی استفاده شود.

total Size

string ( int64 format)

اندازه کل تعداد تخمینی منابع بازگشتی را نشان می دهد. دقیق بودن نمایه های بالای 10k تضمین نمی شود.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/chrome.management.profiles.readonly
  • https://www.googleapis.com/auth/chrome.management.profiles