Method: debug.datasources.items.searchByViewUrl
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אחזור הפריט ש-viewUrl שלו תואם בדיוק לכתובת ה-URL שצוינה בבקשה.
הערה: כדי להפעיל את ה-API הזה, נדרש חשבון אדמין.
בקשת HTTP
POST https://cloudsearch.googleapis.com/v1/debug/{name=datasources/*}/items:searchByViewUrl
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים |
name |
string
שם המקור, בפורמט: datasources/{sourceId}
|
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
{
"viewUrl": string,
"pageToken": string,
"debugOptions": {
object (DebugOptions )
}
} |
שדות |
viewUrl |
string
מציינים את כתובת ה-URL המלאה של התצוגה כדי למצוא את הפריט המתאים. האורך המקסימלי הוא 2048 תווים.
|
pageToken |
string
הערך של nextPageToken שהוחזר מבקשה קודמת, אם יש כזה.
|
debugOptions |
object (DebugOptions )
אפשרויות נפוצות לניפוי באגים.
|
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
{
"items": [
{
object (Item )
}
],
"nextPageToken": string
} |
שדות |
items[] |
object (Item )
|
nextPageToken |
string
אסימון לאחזור של דף התוצאות הבא, או ריק אם אין יותר תוצאות ברשימה.
|
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/cloud_search.debug
https://www.googleapis.com/auth/cloud_search
מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],null,["# Method: debug.datasources.items.searchByViewUrl\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SearchItemsByViewUrlResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nFetches the item whose viewUrl exactly matches that of the URL provided in the request.\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:searchByViewUrl`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|------------------------------------------------------|\n| `name` | `string` Source name, format: datasources/{sourceId} |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"viewUrl\": string, \"pageToken\": string, \"debugOptions\": { object (/workspace/cloud-search/docs/reference/rest/v1/DebugOptions) } } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------|\n| `viewUrl` | `string` Specify the full view URL to find the corresponding item. The maximum length is 2048 characters. |\n| `pageToken` | `string` The nextPageToken value returned from a previous request, if any. |\n| `debugOptions` | `object (`[DebugOptions](/workspace/cloud-search/docs/reference/rest/v1/DebugOptions)`)` Common debug options. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"items\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#Item) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------|\n| `items[]` | `object (`[Item](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#Item)`)` |\n| `nextPageToken` | `string` Token to retrieve the next page of results, or empty if there are no more results in the list. |\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)."]]