मुख्य कंटेंट तक स्किप करें

Web.Contents

url से डाउनलोड की गई सामग्रियों को बाइनरी के रूप में लौटाता है.

Syntax​

Web.Contents(
    url as text,
    optional options as record
) as binary

Remarks​

url से डाउनलोड की गई सामग्री को बाइनरी के रूप में लौटाता है. अतिरिक्त प्रॉपर्टीज़ निर्दिष्ट करने के लिए, एक वैकल्पिक रिकॉर्ड पैरामीटर options प्रदान किया जा सकता है. रिकॉर्ड में निम्नलिखित फ़ील्ड शामिल हो सकते हैं:

  • Query : एस्केपिंग के बारे में चिंता किए बिना, प्रोग्राम द्वारा URL में क्वेरी पैरामीटर जोड़ें.
  • ApiKeyName : यदि लक्ष्य साइट में एक API कुंजी की धारणा है, तो इस पैरामीटर का उपयोग उस कुंजी पैरामीटर के नाम (न मान) को निर्दिष्ट करने के लिए किया जा सकता है जिसका उपयोग URL में किया जाना चाहिए. क्रेडेंशियल में वास्तविक कुंजी मान प्रदान किया गया है.
  • Headers : इस मान को रिकॉर्ड के रूप में निर्दिष्ट करने से किसी HTTP अनुरोध पर अतिरिक्त शीर्ष लेख प्रदान होंगे.
  • Timeout : इस मान को अवधि के रूप में निर्दिष्ट करना HTTP अनुरोध के लिए टाइमआउट को बदल देगा. डिफ़ॉल्ट मान १०० सेकंड है.
  • ExcludedFromCacheKey : इस मान को सूची के रूप में निर्दिष्ट करने से इन HTTP शीर्षलेख कुंजियों को डेटा कैशिंग के लिए परिकलन का भाग होने से बाहर किया जा सकेगा.
  • IsRetry : इस लॉजिकल मान को true के रूप में निर्दिष्ट करने से डेटा फ़ेच करते समय कैश में मौजूद किसी भी मौजूदा प्रतिसाद को अनदेखा कर दिया जाता है.
  • ManualStatusHandling : इस मान को सूची के रूप में निर्दिष्ट करने से उन HTTP अनुरोधों के लिए कोई भी अंतर्निहित हैंडलिंग को रोका जा सकेगा जिनके प्रतिसाद में इनमें से एक स्थिति कोड है.
  • RelativePath : इस मान को पाठ के रूप में निर्दिष्ट करने से अनुरोध करने से पहले उसे आधार URL में जोड़ता है.
  • Content : इस मान को निर्दिष्ट करने से पोस्ट की सामग्री के रूप में विकल्प के मान का उपयोग करके पोस्ट पर प्राप्त होने वाले वेब अनुरोध को परिवर्तित करता है.

HTTP अनुरोध या तो GET (जब कोई सामग्री निर्दिष्ट न हो) के रूप में, या POST (जब कोई सामग्री मौजूद हो) के रूप में किया जाता है. POST अनुरोध केवल गुमनाम रूप से ही किए जा सकते हैं.

HTTP प्रतिसाद के हेडर, बाइनरी परिणाम पर मेटाडेटा के रूप में उपलब्ध होते हैं. कस्टम डेटा कनेक्टर के संदर्भ के बाहर, प्रतिसाद हेडर का केवल एक सबसेट ही उपलब्ध होता है (सुरक्षा कारणों से).

Examples​

Example #1​

RelativePath और Query विकल्पों का उपयोग करके "https://bing.com/search?q=Power+Query" की सामग्री पुनर्प्राप्त करें. इन विकल्पों को डायनेमिक रूप से स्टैटिक बेस URL क्वेरी करने के लिए उपयोग किया जा सकता है.

let
    searchText = "Power Query"
in
    Web.Contents(
        "https://www.bing.com",
        [
            RelativePath = "search",
            Query = [q = searchText]
        ]
    )

Result:

binary

Example #2​

बाइनरी JSON पेलोड पास करके और JSON के रूप में प्रतिसाद को पार्स करते हुए URL के विरुद्ध पोस्ट निष्पादित करें.

let
    url = ...,
    headers = [#"Content-Type" = "application/json"],
    postData = Json.FromValue([x = 235.7, y = 41.53]),
    response = Web.Contents(
        url,
        [
            Headers = headers,
            Content = postData
        ]
    ),
    jsonResponse = Json.Document(response)
in
    jsonResponse

Result:

table

Example #3​

एक सुरक्षित URL से कनेक्ट करें, जो अपनी क्वेरी स्ट्रिंग के हिस्से के रूप में एक प्रमाणीकरण कुंजी स्वीकार करता है. M में गुप्त कुंजी को हार्ड-कोडिंग करने के बजाय (जिससे सुरक्षा को खतरा हो सकता है), M में इसका नाम (इसका मान नहीं) बताकर, Web API प्रमाणीकरण चुनकर, और Web API क्रेडेंशियल के हिस्से के तौर पर कुंजी मान दर्ज करके, कुंजी को सुरक्षित रूप से प्रदान किया जा सकता है. इस तरह से उपयोग किए जाने पर, नीचे दिया गया उदाहरण "https://contoso.com/api/customers/get?api_key=******" पर एक अनुरोध जनरेट करेगा.

Web.Contents("https://contoso.com/api/customers/get", [ApiKeyName="api_key"])

Result:

binary

Category​

Accessing data