Method statements.list

तय किए गए टारगेट और स्टेटमेंट स्ट्रिंग से मेल खाने वाले सोर्स से, ऐसे सभी स्टेटमेंट की सूची हासिल करता है.

एपीआई इस बात की गारंटी देता है कि सुरक्षित सोर्स ऐसेट के सभी स्टेटमेंट, जैसे कि एचटीटीपीएस वेबसाइटें या Android ऐप्लिकेशन, ऐसेट का मालिक सुरक्षित तरीके से तैयार किए गए हैं. इस बारे में डिजिटल ऐसेट लिंक के टेक्निकल डिज़ाइन स्पेसिफ़िकेशन में बताया गया है. खास तौर पर, आपको यह ध्यान रखना चाहिए कि असुरक्षित वेबसाइटों (जहां यूआरएल, https:// के बजाय http:// से शुरू होता है) के लिए, यह गारंटी नहीं दी जा सकती.

List निर्देश उन मामलों में सबसे ज़्यादा फ़ायदेमंद होता है जब एपीआई क्लाइंट यह जानना चाहता हो कि दो ऐसेट एक-दूसरे से कैसे जुड़ी हैं या किसी खास सोर्स ऐसेट के सभी संबंधों की गिनती करनी है. उदाहरण: एक ऐसी सुविधा जिसकी मदद से उपयोगकर्ता, मिलते-जुलते आइटम पर जा सकते हैं. जब किसी डिवाइस पर मोबाइल ऐप्लिकेशन चल रहा होता है, तो इस सुविधा से संबंधित वेबसाइट या Google+ प्रोफ़ाइल पर नेविगेट करना आसान हो जाता है.

एचटीटीपी अनुरोध

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 संबंध वाले एसेट लिंक से मेल खाती है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

सूची कॉल के लिए जवाब देने का मैसेज.

जेएसओएन के काेड में दिखाना 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
फ़ील्ड का नाम टाइप कंपनी का ब्यौरा
statements[] object(Statement) सभी मिलते-जुलते स्टेटमेंट की सूची.
maxAge string

पेश किए जाने के समय से, आगे के अपडेट को रोकने के लिए जवाब को कितने समय तक मान्य माना जाना चाहिए. ज़रूरी है

सेकंड में कुल नौ दशमलव अंकों वाली अवधि, जिसे 's' से खत्म किया जाता है. उदाहरण: "3.5s".
debugString string

इस मैसेज को लोग आसानी से पढ़ सकते हैं. इसमें ऐसी जानकारी होती है जो असली उपयोगकर्ताओं को नतीजे को समझने, उसे समझने, और उसे डीबग करने में मदद करती है.

यह मैसेज अंग्रेज़ी में होगा और फ़िलहाल हम कोई अनुवाद नहीं देंगे.

कृपया ध्यान दें कि इस स्ट्रिंग के कॉन्टेंट या फ़ॉर्मैट के बारे में कोई गारंटी नहीं दी जाती है. इसका कोई भी पहलू बिना किसी सूचना के बदला जा सकता है. आपको इस डेटा को प्रोग्राम के हिसाब से पार्स करने की कोशिश नहीं करनी चाहिए. अगर आपको लगता है कि आपको ऐसा इसलिए करना है, क्योंकि आपकी ज़रूरी जानकारी को एपीआई के ज़रिए बिना अनुमति के सार्वजनिक नहीं किया गया है, तो कृपया पहले हमसे संपर्क करें.

जानकारी

इससे सोर्स ऐसेट और टारगेट ऐसेट के बीच के संबंध के बारे में भरोसेमंद जानकारी मिलती है.

स्टेटमेंट हमेशा सोर्स ऐसेट की मदद से किए जाते हैं. ऐसा सीधे तौर पर या कहीं और सेव की गई स्टेटमेंट सूची को सौंपकर किया जाता है.

स्टेटमेंट और ऐसेट की ज़्यादा जानकारी के लिए, कृपया एपीआई से जुड़े दस्तावेज़ों का लैंडिंग पेज देखें.

जेएसओएन के काेड में दिखाना 
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
फ़ील्ड का नाम टाइप कंपनी का ब्यौरा
source object(Asset) हर स्टेटमेंट का एक सोर्स ऐसेट होता है. ज़रूरी है
relation string

यह संबंध, सोर्स ऐसेट के मालिक (यानी कि स्टेटमेंट जारी करने वाले व्यक्ति या इकाई) के हिसाब से, स्टेटमेंट के इस्तेमाल की पहचान करता है. हर पूरी बात का एक-दूसरे से संबंध होता है.

हम <kind>/<detail> फ़ॉर्मैट की स्ट्रिंग के साथ संबंधों की पहचान करते हैं. यहां <kind>, मकसद की पहले से तय कैटगरी के सेट में से एक होना चाहिए. साथ ही, <detail>, अक्षर और अंक मिलाकर एक फ़्री फ़ॉर्म स्ट्रिंग है, जो स्टेटमेंट के इस्तेमाल के खास उदाहरण के बारे में बताती है.

साथ काम करने वाले संबंधों की मौजूदा सूची के लिए, हमारा एपीआई दस्तावेज़ देखें.

उदाहरण: delegate_permission/common.handle_all_urls ज़रूरी है
target object(Asset) हर स्टेटमेंट की एक टारगेट ऐसेट होती है. ज़रूरी है

इसे आज़माएं!

लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, एपीआई एक्सप्लोरर का इस्तेमाल करें.