Method: debug.datasources.items.checkAccess
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
بررسی می کند که آیا یک مورد توسط اصلی مشخص شده قابل دسترسی است یا خیر. اصلی باید یک کاربر باشد. گروه ها و مقادیر دامنه پشتیبانی نمی شوند.
توجه: این API برای اجرا به یک حساب کاربری نیاز دارد.
درخواست HTTP
POST https://cloudsearch.googleapis.com/v1/debug/{name=datasources/*/items/*}:checkAccess
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
name | string نام مورد، قالب: datasources/{sourceId}/items/{itemId} |
پارامترهای پرس و جو
پارامترها |
---|
debugOptions | object ( DebugOptions ) گزینه های رایج اشکال زدایی |
درخواست بدن
بدنه درخواست شامل نمونه ای از Principal
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"hasAccess": boolean
} |
فیلدها |
---|
hasAccess | boolean اگر اصل دسترسی داشته باشد، true را برمیگرداند. در غیر این صورت false برمی گرداند. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/cloud_search.debug
-
https://www.googleapis.com/auth/cloud_search
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
،
بررسی می کند که آیا یک مورد توسط اصلی مشخص شده قابل دسترسی است یا خیر. اصلی باید یک کاربر باشد. گروه ها و مقادیر دامنه پشتیبانی نمی شوند.
توجه: این API برای اجرا به یک حساب کاربری نیاز دارد.
درخواست HTTP
POST https://cloudsearch.googleapis.com/v1/debug/{name=datasources/*/items/*}:checkAccess
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
name | string نام مورد، قالب: datasources/{sourceId}/items/{itemId} |
پارامترهای پرس و جو
پارامترها |
---|
debugOptions | object ( DebugOptions ) گزینه های رایج اشکال زدایی |
درخواست بدن
بدنه درخواست شامل نمونه ای از Principal
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"hasAccess": boolean
} |
فیلدها |
---|
hasAccess | boolean اگر اصل دسترسی داشته باشد، true را برمیگرداند. در غیر این صورت false برمی گرداند. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/cloud_search.debug
-
https://www.googleapis.com/auth/cloud_search
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: debug.datasources.items.checkAccess\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.CheckAccessResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nChecks whether an item is accessible by specified principal. Principal must be a user; groups and domain values aren't supported.\n\n**Note:** This API requires an admin account to execute.\n\n### HTTP request\n\n`POST https://cloudsearch.googleapis.com/v1/debug/{name=datasources/*/items/*}:checkAccess`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------|\n| `name` | `string` Item name, format: datasources/{sourceId}/items/{itemId} |\n\n### Query parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------|\n| `debugOptions` | `object (`[DebugOptions](/workspace/cloud-search/docs/reference/rest/v1/DebugOptions)`)` Common debug options. |\n\n### Request body\n\nThe request body contains an instance of [Principal](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#Principal).\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------|\n| ``` { \"hasAccess\": boolean } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------|\n| `hasAccess` | `boolean` Returns true if principal has access. Returns false otherwise. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud_search.debug`\n- `https://www.googleapis.com/auth/cloud_search`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]