Method statements.list

فهرستی از تمام عبارات را از یک منبع مشخص که با هدف و رشته دستور مشخص شده مطابقت دارند، بازیابی می کند.

API تضمین می‌کند که همه اظهارات دارای دارایی منبع امن، مانند وب‌سایت‌های HTTPS یا برنامه‌های Android، به روشی ایمن توسط مالک آن دارایی‌ها، همانطور که در مشخصات طراحی فنی پیوندهای دارایی دیجیتال توضیح داده شده است، ارائه شده است. به طور خاص، باید در نظر داشته باشید که برای وب‌سایت‌های ناامن (یعنی جایی که URL به جای http:// با https:// شروع می‌شود)، نمی‌توان این تضمین را انجام داد.

دستور List در مواردی که مشتری API می‌خواهد همه راه‌هایی را که دو دارایی با هم مرتبط هستند بداند یا همه روابط را از یک دارایی منبع خاص برشمرد، بسیار مفید است. مثال: قابلیتی که به کاربران کمک می کند به موارد مرتبط پیمایش کنند. هنگامی که یک برنامه تلفن همراه در دستگاهی اجرا می شود، این ویژگی باعث می شود تا به وب سایت مربوطه یا نمایه +Google پیمایش کنید.

درخواست HTTP

GET https://digitalassetlinks.googleapis.com/v1/statements:list

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

نام پارامتر تایپ کنید شرح
source object( Asset ) منبع میزبان لیست بیانیه. این برای هدایت درخواست List() به منبع مناسب استفاده می شود. ضروری
relation string

فقط از تداعی هایی استفاده کنید که با رابطه مشخص شده مطابقت دارند.

برای تعریف دقیق رشته های رابطه، پیام Statement را ببینید.

برای اینکه یک پرس و جو با یک عبارت مطابقت داشته باشد، یکی از موارد زیر باید درست باشد:

  • هر دو رشته رابطه پرس و جو و عبارت دقیقا مطابقت دارند، یا
  • رشته رابطه پرس و جو خالی یا مفقود است.

مثال: یک پرس و جو با رابطه delegate_permission/common.handle_all_urls یک پیوند دارایی را با رابطه delegate_permission/common.handle_all_urls مطابقت می دهد.

درخواست بدن

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

بدن پاسخگو

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

پیام پاسخ برای تماس فهرست.

نمایندگی JSON
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
نام زمینه تایپ کنید شرح
statements[] object( Statement ) فهرستی از تمام عبارات تطبیقی ​​که پیدا شده است.
maxAge string

از زمان ارائه، چه مدت دیگر پاسخ باید معتبر در نظر گرفته شود و به‌روزرسانی‌های بیشتر ممنوع شود. ضروری

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' خاتمه می یابد. مثال: "3.5s" .

debugString string

پیام قابل خواندن توسط انسان حاوی اطلاعاتی است که برای کمک به کاربران نهایی در درک، بازتولید و اشکال زدایی نتیجه است.

پیام به زبان انگلیسی خواهد بود و ما در حال حاضر قصد نداریم ترجمه ای ارائه دهیم.

لطفاً توجه داشته باشید که هیچ تضمینی در مورد محتوا یا قالب این رشته وجود ندارد. هر جنبه ای از آن ممکن است بدون اطلاع قبلی تغییر کند. شما نباید سعی کنید این داده ها را به صورت برنامه نویسی تجزیه کنید. اگر احساس می کنید که باید این کار را انجام دهید زیرا اطلاعات مورد نیاز شما توسط API در معرض دید دیگری قرار نمی گیرد، لطفاً ابتدا با ما تماس بگیرید.

بیانیه

بیانیه قابل اعتمادی را که در مورد رابطه بین دارایی منبع و دارایی هدف بیان شده است، توصیف می کند.

بیانیه ها همیشه توسط دارایی منبع، مستقیماً یا با تفویض اختیار به فهرست بیانیه ای که در جای دیگری ذخیره می شود، ساخته می شوند.

برای تعاریف دقیق تر بیانیه ها و دارایی ها، لطفاً به صفحه فرود اسناد API ما مراجعه کنید.

نمایندگی JSON
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
نام زمینه تایپ کنید شرح
source object( Asset ) هر بیانیه دارای منبع دارایی است. ضروری
relation string

این رابطه، استفاده از بیانیه را به عنوان مورد نظر صاحب دارایی مبدأ (یعنی شخص یا نهادی که بیانیه را صادر کرده است) مشخص می کند. هر عبارت کامل یک رابطه دارد.

ما روابط را با رشته‌هایی با قالب <kind>/<detail> شناسایی می‌کنیم، که در آن <kind> باید یکی از مجموعه‌ای از مقوله‌های هدف از پیش تعریف شده باشد، و <detail> یک رشته حروف عددی با حروف کوچک آزاد است که کاربرد خاص را توصیف می‌کند. مورد بیانیه

برای لیست فعلی روابط پشتیبانی شده به اسناد API ما مراجعه کنید.

مثال: delegate_permission/common.handle_all_urls REQUIRED

target object( Asset ) هر بیانیه دارایی هدف دارد. ضروری

آن را امتحان کنید!

از APIs Explorer برای فراخوانی این روش روی داده های زنده و دیدن پاسخ استفاده کنید.