স্মার্ট চিপগুলির সাথে লিঙ্কগুলির পূর্বরূপ দেখুন

এই পৃষ্ঠাটি ব্যাখ্যা করে যে কীভাবে একটি Google Workspace অ্যাড-অন তৈরি করতে হয় যা Google Docs, Sheets এবং Slides ব্যবহারকারীদের তৃতীয় পক্ষের পরিষেবা থেকে লিঙ্কের প্রিভিউ দেখতে দেয়।

একটি Google Workspace অ্যাড-অন আপনার পরিষেবার লিঙ্ক শনাক্ত করতে পারে এবং ব্যবহারকারীদের সেগুলি প্রিভিউ করতে প্রম্পট করতে পারে। আপনি একাধিক ইউআরএল প্যাটার্নের পূর্বরূপ দেখতে একটি অ্যাড-অন কনফিগার করতে পারেন, যেমন সমর্থন কেস, বিক্রয় লিড এবং কর্মচারী প্রোফাইলের লিঙ্ক।

ব্যবহারকারীরা কীভাবে লিঙ্কগুলির পূর্বরূপ দেখেন

লিঙ্কগুলির পূর্বরূপ দেখতে, ব্যবহারকারীরা স্মার্ট চিপস এবং কার্ডগুলির সাথে যোগাযোগ করে৷

যখন ব্যবহারকারীরা একটি নথিতে একটি URL টাইপ বা পেস্ট করে, Google ডক্স তাদেরকে একটি স্মার্ট চিপ দিয়ে লিঙ্কটি প্রতিস্থাপন করতে অনুরোধ করে। স্মার্ট চিপ একটি আইকন এবং সংক্ষিপ্ত শিরোনাম বা লিঙ্কের বিষয়বস্তুর বিবরণ প্রদর্শন করে। ব্যবহারকারী যখন চিপের উপর ঘোরায়, তখন তারা একটি কার্ড ইন্টারফেস দেখতে পায় যা ফাইল বা লিঙ্ক সম্পর্কে আরও তথ্যের পূর্বরূপ দেখায়।

নিম্নলিখিত ভিডিওটি দেখায় যে কীভাবে একজন ব্যবহারকারী একটি লিঙ্ককে একটি স্মার্ট চিপে রূপান্তর করে এবং একটি কার্ডের পূর্বরূপ দেখেন:

ব্যবহারকারীরা কীভাবে পত্রক এবং স্লাইডে লিঙ্কগুলির পূর্বরূপ দেখেন

তৃতীয় পক্ষের স্মার্ট চিপগুলি পত্রক এবং স্লাইডে লিঙ্কের পূর্বরূপগুলির জন্য সমর্থিত নয়৷ যখন ব্যবহারকারীরা একটি স্প্রেডশীট বা উপস্থাপনায় একটি URL টাইপ বা পেস্ট করে, তখন শীট বা স্লাইডগুলি তাদের চিপের পরিবর্তে লিঙ্কযুক্ত পাঠ্য হিসাবে তার শিরোনামের সাথে লিঙ্কটি প্রতিস্থাপন করতে অনুরোধ করে। ব্যবহারকারী যখন লিঙ্কের শিরোনামের উপর ঘোরায়, তখন তারা একটি কার্ড ইন্টারফেস দেখতে পায় যা লিঙ্ক সম্পর্কে তথ্যের পূর্বরূপ দেখায়।

নিম্নলিখিত চিত্রটি দেখায় যে কীভাবে একটি লিঙ্ক প্রিভিউ পত্রক এবং স্লাইডে রেন্ডার হয়:

পূর্বশর্ত

অ্যাপস স্ক্রিপ্ট

• একটি Google Workspace অ্যাকাউন্ট।
• একটি Google Workspace অ্যাড-অন। একটি অ্যাড-অন তৈরি করতে, এই কুইকস্টার্টটি অনুসরণ করুন।

Node.js

• একটি Google Workspace অ্যাকাউন্ট।
• একটি Google Workspace অ্যাড-অন। একটি অ্যাড-অন তৈরি করতে, এই কুইকস্টার্টটি অনুসরণ করুন।

দ্রষ্টব্য: এই নির্দেশিকায় Node.js কোড নমুনাগুলি একটি ক্লাউড ফাংশন হিসাবে চালানোর জন্য লেখা হয়েছে৷

পাইথন

• একটি Google Workspace অ্যাকাউন্ট।
• একটি Google Workspace অ্যাড-অন। একটি অ্যাড-অন তৈরি করতে, এই কুইকস্টার্টটি অনুসরণ করুন।

দ্রষ্টব্য: এই নির্দেশিকায় পাইথন কোডের নমুনাগুলি পাইথন 3.9 ব্যবহার করে ক্লাউড ফাংশন হিসাবে চালানোর জন্য লেখা হয়েছে।

জাভা

• একটি Google Workspace অ্যাকাউন্ট।
• একটি Google Workspace অ্যাড-অন। একটি অ্যাড-অন তৈরি করতে, এই কুইকস্টার্টটি অনুসরণ করুন।

ঐচ্ছিক: তৃতীয় পক্ষের পরিষেবাতে প্রমাণীকরণ সেট আপ করুন

যদি আপনার অ্যাড-অন এমন একটি পরিষেবার সাথে সংযোগ করে যার জন্য অনুমোদনের প্রয়োজন হয়, ব্যবহারকারীদের অবশ্যই লিঙ্কগুলির পূর্বরূপ দেখতে পরিষেবাটিতে প্রমাণীকরণ করতে হবে৷ এর মানে হল যে ব্যবহারকারীরা যখন আপনার পরিষেবা থেকে একটি ডক্স, পত্রক বা স্লাইড ফাইলে প্রথমবার একটি লিঙ্ক পেস্ট করে, তখন আপনার অ্যাড-অনকে অবশ্যই অনুমোদনের প্রবাহ শুরু করতে হবে।

একটি OAuth পরিষেবা বা কাস্টম অনুমোদন প্রম্পট সেট আপ করতে, নিম্নলিখিত গাইডগুলির মধ্যে একটি দেখুন:

• আপনি অ্যাপস স্ক্রিপ্ট ব্যবহার করে আপনার অ্যাড-অন তৈরি করলে, Google Workspace অ্যাড-অন থেকে নন-Google পরিষেবাগুলিতে কানেক্ট করা দেখুন।

• আপনি যদি একটি ভিন্ন রানটাইম ব্যবহার করে আপনার অ্যাড-অন তৈরি করেন, তাহলে আপনার অ্যাড-অনকে একটি তৃতীয় পক্ষের পরিষেবাতে সংযুক্ত করুন দেখুন।

আপনার অ্যাড-অনের জন্য লিঙ্ক প্রিভিউ সেট আপ করুন

এই বিভাগটি ব্যাখ্যা করে যে কীভাবে আপনার অ্যাড-অনের জন্য লিঙ্ক প্রিভিউ সেট আপ করবেন, এতে নিম্নলিখিত পদক্ষেপগুলি অন্তর্ভুক্ত রয়েছে:

1. আপনার অ্যাড-অনের স্থাপনার সংস্থান বা ম্যানিফেস্ট ফাইলে লিঙ্ক প্রিভিউ কনফিগার করুন ।
2. আপনার লিঙ্কগুলির জন্য স্মার্ট চিপ এবং কার্ড ইন্টারফেস তৈরি করুন ।

লিঙ্ক প্রিভিউ কনফিগার করুন

লিঙ্ক প্রিভিউ কনফিগার করতে, আপনার অ্যাড-অনের স্থাপনার সংস্থান বা ম্যানিফেস্ট ফাইলে নিম্নলিখিত বিভাগ এবং ক্ষেত্রগুলি নির্দিষ্ট করুন:

1. addOns বিভাগের অধীনে, ডক্স প্রসারিত করতে docs ক্ষেত্র, পত্রক প্রসারিত করতে sheets ক্ষেত্র এবং স্লাইডগুলি প্রসারিত করতে slides ক্ষেত্র যোগ করুন।

2. প্রতিটি ক্ষেত্রে, linkPreviewTriggers ট্রিগার প্রয়োগ করুন যাতে একটি runFunction রয়েছে (আপনি নিম্নলিখিত বিভাগে এই ফাংশনটি সংজ্ঞায়িত করুন, স্মার্ট চিপ এবং কার্ড তৈরি করুন )।

   linkPreviewTriggers ট্রিগারে আপনি কোন ক্ষেত্রগুলি নির্দিষ্ট করতে পারেন সে সম্পর্কে জানতে, Apps Script ম্যানিফেস্ট ফাইলগুলির জন্য রেফারেন্স ডকুমেন্টেশন বা অন্যান্য রানটাইমগুলির জন্য স্থাপনার সংস্থানগুলি দেখুন৷

3. oauthScopes ক্ষেত্রে, স্কোপটি যুক্ত করুন https://www.googleapis.com/auth/workspace.linkpreview যাতে ব্যবহারকারীরা তাদের পক্ষ থেকে লিঙ্কগুলির পূর্বরূপ দেখার জন্য অ্যাড-অনটিকে অনুমোদন করতে পারে৷

উদাহরণ হিসেবে, নিচের ডিপ্লয়মেন্ট রিসোর্সের oauthScopes এবং addons বিভাগটি দেখুন যা একটি সাপোর্ট কেস সার্ভিসের জন্য লিঙ্ক প্রিভিউ কনফিগার করে।

দ্রষ্টব্য: শীট এবং স্লাইডের জন্য, labelText এবং localizedLabelText রেন্ডার হয় না, তবে শীট এবং স্লাইডগুলি যখন তৃতীয় পক্ষের স্মার্ট চিপগুলিকে সমর্থন করতে শুরু করে তখন আপনাকে অবশ্যই labelText অন্তর্ভুক্ত করতে হবে৷ localizedLabelText ঐচ্ছিক।

{
  "oauthScopes": [
    "https://www.googleapis.com/auth/workspace.linkpreview"
  ],
  "addOns": {
    "common": {
      "name": "Preview support cases",
      "logoUrl": "https://www.example.com/images/company-logo.png",
      "layoutProperties": {
        "primaryColor": "#dd4b39"
      }
    },
    "docs": {
      "linkPreviewTriggers": [
        {
          "runFunction": "caseLinkPreview",
          "patterns": [
            {
              "hostPattern": "example.com",
              "pathPrefix": "support/cases"
            },
            {
              "hostPattern": "*.example.com",
              "pathPrefix": "cases"
            },
            {
              "hostPattern": "cases.example.com"
            }
          ],
          "labelText": "Support case",
          "logoUrl": "https://www.example.com/images/support-icon.png",
          "localizedLabelText": {
            "es": "Caso de soporte"
          }
        }
      ]
    },
    "sheets": {
      "linkPreviewTriggers": [
        {
          "runFunction": "caseLinkPreview",
          "patterns": [
            {
              "hostPattern": "example.com",
              "pathPrefix": "support/cases"
            },
            {
              "hostPattern": "*.example.com",
              "pathPrefix": "cases"
            },
            {
              "hostPattern": "cases.example.com"
            }
          ],
          "labelText": "Support case",
          "logoUrl": "https://www.example.com/images/support-icon.png",
          "localizedLabelText": {
            "es": "Caso de soporte"
          }
        }
      ]
    },
    "slides": {
      "linkPreviewTriggers": [
        {
          "runFunction": "caseLinkPreview",
          "patterns": [
            {
              "hostPattern": "example.com",
              "pathPrefix": "support/cases"
            },
            {
              "hostPattern": "*.example.com",
              "pathPrefix": "cases"
            },
            {
              "hostPattern": "cases.example.com"
            }
          ],
          "labelText": "Support case",
          "logoUrl": "https://www.example.com/images/support-icon.png",
          "localizedLabelText": {
            "es": "Caso de soporte"
          }
        }
      ]
    }
  }
}

উদাহরণে, Google Workspace অ্যাড-অন একটি কোম্পানির সহায়তা কেস পরিষেবার জন্য প্রিভিউ লিঙ্ক। অ্যাড-অন লিঙ্কগুলির পূর্বরূপ দেখতে তিনটি URL প্যাটার্ন নির্দিষ্ট করে। যখনই একটি লিঙ্ক URL প্যাটার্নগুলির একটির সাথে মেলে, কলব্যাক ফাংশন caseLinkPreview একটি কার্ড এবং একটি স্মার্ট চিপ তৈরি করে এবং প্রদর্শন করে, বা পত্রক এবং স্লাইডে, লিঙ্ক শিরোনাম দিয়ে URLটিকে প্রতিস্থাপন করে৷

স্মার্ট চিপ এবং কার্ড তৈরি করুন

একটি লিঙ্কের জন্য একটি স্মার্ট চিপ এবং কার্ড ফেরত দিতে, আপনাকে অবশ্যই linkPreviewTriggers অবজেক্টে নির্দিষ্ট করা যেকোনো ফাংশন বাস্তবায়ন করতে হবে।

যখন একজন ব্যবহারকারী একটি নির্দিষ্ট URL প্যাটার্নের সাথে মেলে এমন একটি লিঙ্কের সাথে ইন্টারঅ্যাক্ট করে, linkPreviewTriggers ট্রিগার ফায়ার করে এবং এর কলব্যাক ফাংশন ইভেন্ট অবজেক্ট EDITOR_NAME .matchedUrl.url একটি যুক্তি হিসাবে পাস করে। আপনি আপনার লিঙ্কের পূর্বরূপের জন্য স্মার্ট চিপ এবং কার্ড তৈরি করতে এই ইভেন্ট অবজেক্টের পেলোড ব্যবহার করেন।

উদাহরণস্বরূপ, যদি কোনও ব্যবহারকারী ডক্সে https://www.example.com/cases/123456 লিঙ্কটির পূর্বরূপ দেখেন, তাহলে নিম্নলিখিত ইভেন্ট পেলোডটি ফেরত দেওয়া হবে:

JSON

{
  "docs": {
    "matchedUrl": {
        "url": "https://www.example.com/support/cases/123456"
    }
  }
}

কার্ড ইন্টারফেস তৈরি করতে, আপনি লিঙ্ক সম্পর্কে তথ্য প্রদর্শন করতে উইজেট ব্যবহার করেন। আপনি এমন অ্যাকশনও তৈরি করতে পারেন যা ব্যবহারকারীদের লিঙ্ক খুলতে বা এর বিষয়বস্তু পরিবর্তন করতে দেয়। উপলব্ধ উইজেট এবং ক্রিয়াগুলির একটি তালিকার জন্য, পূর্বরূপ কার্ডগুলির জন্য সমর্থিত উপাদানগুলি দেখুন।

একটি লিঙ্ক পূর্বরূপের জন্য স্মার্ট চিপ এবং কার্ড তৈরি করতে:

1. আপনার অ্যাড-অনের স্থাপনার সংস্থান বা ম্যানিফেস্ট ফাইলের linkPreviewTriggers বিভাগে আপনি যে ফাংশনটি নির্দিষ্ট করেছেন তা প্রয়োগ করুন:
   1. ফাংশনটিকে অবশ্যই একটি ইভেন্ট অবজেক্ট গ্রহণ করতে হবে যাতে EDITOR_NAME .matchedUrl.url একটি যুক্তি হিসাবে থাকে এবং একটি একক Card অবজেক্ট ফেরত দেয়৷
   2. যদি আপনার পরিষেবার অনুমোদনের প্রয়োজন হয়, তাহলে ফাংশনটিকে অবশ্যই অনুমোদনের প্রবাহকে আহ্বান করতে হবে ।
2. প্রতিটি পূর্বরূপ কার্ডের জন্য, ইন্টারফেসের জন্য উইজেট ইন্টারঅ্যাক্টিভিটি প্রদান করে এমন যেকোনো কলব্যাক ফাংশন বাস্তবায়ন করুন। উদাহরণস্বরূপ, যদি আপনি "লিঙ্ক দেখুন" বলে একটি বোতাম অন্তর্ভুক্ত করেন তবে আপনি একটি ক্রিয়া তৈরি করতে পারেন যা একটি নতুন উইন্ডোতে লিঙ্কটি খুলতে একটি কলব্যাক ফাংশন নির্দিষ্ট করে৷ উইজেট মিথস্ক্রিয়া সম্পর্কে আরও জানতে, অ্যাড-অন অ্যাকশনগুলি দেখুন।

দ্রষ্টব্য: লিঙ্কের পূর্বরূপগুলির জন্য, কার্ড প্রতিক্রিয়া প্রতিটি ব্যবহারকারীর জন্য 5 মিনিটের জন্য ক্যাশ করা হয়। সেই সময়ের মধ্যে, যদি একজন ব্যবহারকারী একটি লিঙ্কের পূর্বরূপ দেখেন, তারা ক্যাশে করা প্রতিক্রিয়া পাবেন। ব্যবহারকারী ফাইলটি রিফ্রেশ করলে বা 5 মিনিট পরে ক্যাশে সাফ হয়। ফেরত দেওয়া কার্ডের শিরোনাম পরিবর্তিত হলে, অ্যাপটি ব্যবহারকারীকে শিরোনামটি রিফ্রেশ করতে অনুরোধ করে।

নিম্নলিখিত কোডটি ডক্সের জন্য কলব্যাক ফাংশন caseLinkPreview তৈরি করে:

অ্যাপস স্ক্রিপ্ট

apps-script/3p-resources/3p-resources.gs

GitHub এ দেখুন

/**
* Entry point for a support case link preview.
*
* @param {!Object} event The event object.
* @return {!Card} The resulting preview link card.
*/
function caseLinkPreview(event) {

  // If the event object URL matches a specified pattern for support case links.
  if (event.docs.matchedUrl.url) {

    // Uses the event object to parse the URL and identify the case details.
    const caseDetails = parseQuery(event.docs.matchedUrl.url);

    // Builds a preview card with the case name, and description
    const caseHeader = CardService.newCardHeader()
      .setTitle(`Case ${caseDetails["name"][0]}`);
    const caseDescription = CardService.newTextParagraph()
      .setText(caseDetails["description"][0]);

    // Returns the card.
    // Uses the text from the card's header for the title of the smart chip.
    return CardService.newCardBuilder()
      .setHeader(caseHeader)
      .addSection(CardService.newCardSection().addWidget(caseDescription))
      .build();
  }
}

/**
* Extracts the URL parameters from the given URL.
*
* @param {!string} url The URL to parse.
* @return {!Map} A map with the extracted URL parameters.
*/
function parseQuery(url) {
  const query = url.split("?")[1];
  if (query) {
    return query.split("&")
    .reduce(function(o, e) {
      var temp = e.split("=");
      var key = temp[0].trim();
      var value = temp[1].trim();
      value = isNaN(value) ? value : Number(value);
      if (o[key]) {
        o[key].push(value);
      } else {
        o[key] = [value];
      }
      return o;
    }, {});
  }
  return null;
}

Node.js

node/3p-resources/index.js

GitHub এ দেখুন

/**
 * 
 * A support case link preview.
 *
 * @param {!URL} url The event object.
 * @return {!Card} The resulting preview link card.
 */
function caseLinkPreview(url) {
  // Builds a preview card with the case name, and description
  // Uses the text from the card's header for the title of the smart chip.
  // Parses the URL and identify the case details.
  const name = `Case ${url.searchParams.get("name")}`;
  return {
    action: {
      linkPreview: {
        title: name,
        previewCard: {
          header: {
            title: name
          },
          sections: [{
            widgets: [{
              textParagraph: {
                text: url.searchParams.get("description")
              }
            }]
          }]
        }
      }
    }
  };
}

পাইথন

python/3p-resources/create_link_preview/main.py

GitHub এ দেখুন

def case_link_preview(url):
    """A support case link preview.
    Args:
      url: A matching URL.
    Returns:
      The resulting preview link card.
    """

    # Parses the URL and identify the case details.
    query_string = parse_qs(url.query)
    name = f'Case {query_string["name"][0]}'
    # Uses the text from the card's header for the title of the smart chip.
    return {
        "action": {
            "linkPreview": {
                "title": name,
                "previewCard": {
                    "header": {
                        "title": name
                    },
                    "sections": [{
                        "widgets": [{
                            "textParagraph": {
                                "text": query_string["description"][0]
                            }
                        }]
                    }],
                }
            }
        }
    }

জাভা

java/3p-resources/src/main/java/CreateLinkPreview.java

GitHub এ দেখুন

/**
 * A support case link preview.
 *
 * @param url A matching URL.
 * @return The resulting preview link card.
 */
JsonObject caseLinkPreview(URL url) throws UnsupportedEncodingException {
  // Parses the URL and identify the case details.
  Map<String, String> caseDetails = new HashMap<String, String>();
  for (String pair : url.getQuery().split("&")) {
      caseDetails.put(URLDecoder.decode(pair.split("=")[0], "UTF-8"), URLDecoder.decode(pair.split("=")[1], "UTF-8"));
  }

  // Builds a preview card with the case name, and description
  // Uses the text from the card's header for the title of the smart chip.
  JsonObject cardHeader = new JsonObject();
  String caseName = String.format("Case %s", caseDetails.get("name"));
  cardHeader.add("title", new JsonPrimitive(caseName));

  JsonObject textParagraph = new JsonObject();
  textParagraph.add("text", new JsonPrimitive(caseDetails.get("description")));

  JsonObject widget = new JsonObject();
  widget.add("textParagraph", textParagraph);

  JsonArray widgets = new JsonArray();
  widgets.add(widget);

  JsonObject section = new JsonObject();
  section.add("widgets", widgets);

  JsonArray sections = new JsonArray();
  sections.add(section);

  JsonObject previewCard = new JsonObject();
  previewCard.add("header", cardHeader);
  previewCard.add("sections", sections);

  JsonObject linkPreview = new JsonObject();
  linkPreview.add("title", new JsonPrimitive(caseName));
  linkPreview.add("previewCard", previewCard);

  JsonObject action = new JsonObject();
  action.add("linkPreview", linkPreview);

  JsonObject renderActions = new JsonObject();
  renderActions.add("action", action);

  return renderActions;
}

পূর্বরূপ কার্ডের জন্য সমর্থিত উপাদান

Google Workspace অ্যাড-অনগুলি লিঙ্ক প্রিভিউ কার্ডের জন্য নিম্নলিখিত উইজেট এবং অ্যাকশন সমর্থন করে:

অ্যাপস স্ক্রিপ্ট

কার্ড পরিষেবা ক্ষেত্র	টাইপ
TextParagraph	উইজেট
DecoratedText	উইজেট
Image	উইজেট
IconImage	উইজেট
ButtonSet	উইজেট
TextButton	উইজেট
ImageButton	উইজেট
Grid	উইজেট
Divider	উইজেট
OpenLink	কর্ম
Navigation	কর্ম শুধুমাত্র updateCard পদ্ধতি সমর্থিত।

JSON

কার্ড ( google.apps.card.v1 ) ক্ষেত্র	টাইপ
TextParagraph	উইজেট
DecoratedText	উইজেট
Image	উইজেট
Icon	উইজেট
ButtonList	উইজেট
Button	উইজেট
Grid	উইজেট
Divider	উইজেট
OpenLink	কর্ম
Navigation	কর্ম শুধুমাত্র updateCard পদ্ধতি সমর্থিত।

সম্পূর্ণ উদাহরণ: সাপোর্ট কেস অ্যাড-অন

নিম্নলিখিত উদাহরণে একটি Google Workspace অ্যাড-অন রয়েছে যা Google ডক্সে কোম্পানির সহায়তা সংক্রান্ত ক্ষেত্রে লিঙ্কগুলির প্রিভিউ দেখায়।

উদাহরণ নিম্নলিখিত কাজ করে:

• সহায়তার ক্ষেত্রে লিঙ্কগুলির পূর্বরূপ দেখায়, যেমন https://www.example.com/support/cases/1234 । স্মার্ট চিপ একটি সমর্থন আইকন প্রদর্শন করে, এবং পূর্বরূপ কার্ডে কেস আইডি এবং একটি বিবরণ অন্তর্ভুক্ত থাকে।
• ব্যবহারকারীর লোকেল স্প্যানিশে সেট করা থাকলে, স্মার্ট চিপ তার labelText স্প্যানিশ ভাষায় স্থানীয়করণ করে।

স্থাপনার সম্পদ

অ্যাপস স্ক্রিপ্ট

apps-script/3p-resources/appsscript.json

GitHub এ দেখুন

{
  "timeZone": "America/New_York",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/workspace.linkpreview",
    "https://www.googleapis.com/auth/workspace.linkcreate"
  ],
  "addOns": {
    "common": {
      "name": "Manage support cases",
      "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png",
      "layoutProperties": {
        "primaryColor": "#dd4b39"
      }
    },
    "docs": {
      "linkPreviewTriggers": [
        {
          "runFunction": "caseLinkPreview",
          "patterns": [
            {
              "hostPattern": "example.com",
              "pathPrefix": "support/cases"
            },
            {
              "hostPattern": "*.example.com",
              "pathPrefix": "cases"
            },
            {
              "hostPattern": "cases.example.com"
            }
          ],
          "labelText": "Support case",
          "localizedLabelText": {
            "es": "Caso de soporte"
          },
          "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png"
        }
      ],
      "createActionTriggers": [
        {
          "id": "createCase",
          "labelText": "Create support case",
          "localizedLabelText": {
            "es": "Crear caso de soporte"
          },
          "runFunction": "createCaseInputCard",
          "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png"
        }
      ]
    }
  }
}

JSON

দ্রষ্টব্য: নিম্নলিখিত স্থাপনার সংস্থান ব্যবহার করতে, URL মানটি স্থাপন করা ফাংশনের URL দিয়ে প্রতিস্থাপন করুন। আপনি কোড নমুনা ব্যবহার করে ফাংশন স্থাপন করতে পারেন।

{
  "oauthScopes": [
    "https://www.googleapis.com/auth/workspace.linkpreview"
  ],
  "addOns": {
    "common": {
      "name": "Preview support cases",
      "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png",
      "layoutProperties": {
        "primaryColor": "#dd4b39"
      }
    },
    "docs": {
      "linkPreviewTriggers": [
        {
          "runFunction": "URL",
          "patterns": [
            {
              "hostPattern": "example.com",
              "pathPrefix": "support/cases"
            },
            {
              "hostPattern": "*.example.com",
              "pathPrefix": "cases"
            },
            {
              "hostPattern": "cases.example.com"
            }
          ],
          "labelText": "Support case",
          "localizedLabelText": {
            "es": "Caso de soporte"
          },
          "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png"
        }
      ]
    }
  }
}

কোড

অ্যাপস স্ক্রিপ্ট

apps-script/3p-resources/3p-resources.gs

GitHub এ দেখুন

/**
* Entry point for a support case link preview.
*
* @param {!Object} event The event object.
* @return {!Card} The resulting preview link card.
*/
function caseLinkPreview(event) {

  // If the event object URL matches a specified pattern for support case links.
  if (event.docs.matchedUrl.url) {

    // Uses the event object to parse the URL and identify the case details.
    const caseDetails = parseQuery(event.docs.matchedUrl.url);

    // Builds a preview card with the case name, and description
    const caseHeader = CardService.newCardHeader()
      .setTitle(`Case ${caseDetails["name"][0]}`);
    const caseDescription = CardService.newTextParagraph()
      .setText(caseDetails["description"][0]);

    // Returns the card.
    // Uses the text from the card's header for the title of the smart chip.
    return CardService.newCardBuilder()
      .setHeader(caseHeader)
      .addSection(CardService.newCardSection().addWidget(caseDescription))
      .build();
  }
}

/**
* Extracts the URL parameters from the given URL.
*
* @param {!string} url The URL to parse.
* @return {!Map} A map with the extracted URL parameters.
*/
function parseQuery(url) {
  const query = url.split("?")[1];
  if (query) {
    return query.split("&")
    .reduce(function(o, e) {
      var temp = e.split("=");
      var key = temp[0].trim();
      var value = temp[1].trim();
      value = isNaN(value) ? value : Number(value);
      if (o[key]) {
        o[key].push(value);
      } else {
        o[key] = [value];
      }
      return o;
    }, {});
  }
  return null;
}

Node.js

node/3p-resources/index.js

GitHub এ দেখুন

/**
 * Responds to any HTTP request related to link previews.
 *
 * @param {Object} req An HTTP request context.
 * @param {Object} res An HTTP response context.
 */
exports.createLinkPreview = (req, res) => {
  const event = req.body;
  if (event.docs.matchedUrl.url) {
    const url = event.docs.matchedUrl.url;
    const parsedUrl = new URL(url);
    // If the event object URL matches a specified pattern for preview links.
    if (parsedUrl.hostname === 'example.com') {
      if (parsedUrl.pathname.startsWith('/support/cases/')) {
        return res.json(caseLinkPreview(parsedUrl));
      }
    }
  }
};


/**
 * 
 * A support case link preview.
 *
 * @param {!URL} url The event object.
 * @return {!Card} The resulting preview link card.
 */
function caseLinkPreview(url) {
  // Builds a preview card with the case name, and description
  // Uses the text from the card's header for the title of the smart chip.
  // Parses the URL and identify the case details.
  const name = `Case ${url.searchParams.get("name")}`;
  return {
    action: {
      linkPreview: {
        title: name,
        previewCard: {
          header: {
            title: name
          },
          sections: [{
            widgets: [{
              textParagraph: {
                text: url.searchParams.get("description")
              }
            }]
          }]
        }
      }
    }
  };
}

পাইথন

python/3p-resources/create_link_preview/main.py

GitHub এ দেখুন

from typing import Any, Mapping
from urllib.parse import urlparse, parse_qs

import flask
import functions_framework


@functions_framework.http
def create_link_preview(req: flask.Request):
    """Responds to any HTTP request related to link previews.
    Args:
      req: An HTTP request context.
    Returns:
      An HTTP response context.
    """
    event = req.get_json(silent=True)
    if event["docs"]["matchedUrl"]["url"]:
        url = event["docs"]["matchedUrl"]["url"]
        parsed_url = urlparse(url)
        # If the event object URL matches a specified pattern for preview links.
        if parsed_url.hostname == "example.com":
            if parsed_url.path.startswith("/support/cases/"):
                return case_link_preview(parsed_url)

    return {}




def case_link_preview(url):
    """A support case link preview.
    Args:
      url: A matching URL.
    Returns:
      The resulting preview link card.
    """

    # Parses the URL and identify the case details.
    query_string = parse_qs(url.query)
    name = f'Case {query_string["name"][0]}'
    # Uses the text from the card's header for the title of the smart chip.
    return {
        "action": {
            "linkPreview": {
                "title": name,
                "previewCard": {
                    "header": {
                        "title": name
                    },
                    "sections": [{
                        "widgets": [{
                            "textParagraph": {
                                "text": query_string["description"][0]
                            }
                        }]
                    }],
                }
            }
        }
    }

জাভা

java/3p-resources/src/main/java/CreateLinkPreview.java

GitHub এ দেখুন

import com.google.cloud.functions.HttpFunction;
import com.google.cloud.functions.HttpRequest;
import com.google.cloud.functions.HttpResponse;
import com.google.gson.Gson;
import com.google.gson.JsonArray;
import com.google.gson.JsonObject;
import com.google.gson.JsonPrimitive;

import java.io.UnsupportedEncodingException;
import java.net.URL;
import java.net.URLDecoder;
import java.util.HashMap;
import java.util.Map;

public class CreateLinkPreview implements HttpFunction {
  private static final Gson gson = new Gson();

  /**
   * Responds to any HTTP request related to link previews.
   *
   * @param request An HTTP request context.
   * @param response An HTTP response context.
   */
  @Override
  public void service(HttpRequest request, HttpResponse response) throws Exception {
    JsonObject event = gson.fromJson(request.getReader(), JsonObject.class);
    String url = event.getAsJsonObject("docs")
        .getAsJsonObject("matchedUrl")
        .get("url")
        .getAsString();
    URL parsedURL = new URL(url);
    // If the event object URL matches a specified pattern for preview links.
    if ("example.com".equals(parsedURL.getHost())) {
      if (parsedURL.getPath().startsWith("/support/cases/")) {
        response.getWriter().write(gson.toJson(caseLinkPreview(parsedURL)));
        return;
      }
    }

    response.getWriter().write("{}");
  }


  /**
   * A support case link preview.
   *
   * @param url A matching URL.
   * @return The resulting preview link card.
   */
  JsonObject caseLinkPreview(URL url) throws UnsupportedEncodingException {
    // Parses the URL and identify the case details.
    Map<String, String> caseDetails = new HashMap<String, String>();
    for (String pair : url.getQuery().split("&")) {
        caseDetails.put(URLDecoder.decode(pair.split("=")[0], "UTF-8"), URLDecoder.decode(pair.split("=")[1], "UTF-8"));
    }

    // Builds a preview card with the case name, and description
    // Uses the text from the card's header for the title of the smart chip.
    JsonObject cardHeader = new JsonObject();
    String caseName = String.format("Case %s", caseDetails.get("name"));
    cardHeader.add("title", new JsonPrimitive(caseName));

    JsonObject textParagraph = new JsonObject();
    textParagraph.add("text", new JsonPrimitive(caseDetails.get("description")));

    JsonObject widget = new JsonObject();
    widget.add("textParagraph", textParagraph);

    JsonArray widgets = new JsonArray();
    widgets.add(widget);

    JsonObject section = new JsonObject();
    section.add("widgets", widgets);

    JsonArray sections = new JsonArray();
    sections.add(section);

    JsonObject previewCard = new JsonObject();
    previewCard.add("header", cardHeader);
    previewCard.add("sections", sections);

    JsonObject linkPreview = new JsonObject();
    linkPreview.add("title", new JsonPrimitive(caseName));
    linkPreview.add("previewCard", previewCard);

    JsonObject action = new JsonObject();
    action.add("linkPreview", linkPreview);

    JsonObject renderActions = new JsonObject();
    renderActions.add("action", action);

    return renderActions;
  }

}

সম্পর্কিত সম্পদ

• আপনার অ্যাড-অন পরীক্ষা করুন
• ঘটনা বস্তু
• বিল্ডিং এডিটর ইন্টারফেস
• সম্পাদক ম্যানিফেস্ট সম্পদ