পরামর্শ নিয়ে কাজ করুন, পরামর্শ নিয়ে কাজ করুন

গুগল ডক্স সহযোগীদের এমন পরামর্শ দেওয়ার সুযোগ দেয়, যা কার্যকরভাবে অনুমোদনের অপেক্ষায় থাকা স্থগিত সম্পাদনা হিসেবে কাজ করে।

আপনি এপিআই ব্যবহার করে সাজেশনগুলো দেখতে পারবেন, কিন্তু প্রোগ্রাম্যাটিকভাবে সেগুলো গ্রহণ, প্রত্যাখ্যান বা তৈরি করতে পারবেন না।

যখন আপনি ডকুমেন্টের বিষয়বস্তু আনার জন্য documents.get মেথড ব্যবহার করেন, তখন সেই বিষয়বস্তুতে অমীমাংসিত সাজেশন অন্তর্ভুক্ত থাকতে পারে। documents.get কীভাবে সাজেশনগুলো উপস্থাপন করবে তা নিয়ন্ত্রণ করতে, ঐচ্ছিক SuggestionsViewMode প্যারামিটারটি ব্যবহার করুন। এই প্যারামিটারটির সাথে নিম্নলিখিত ফিল্টার শর্তগুলো উপলব্ধ রয়েছে:

  • SUGGESTIONS_INLINE সহ কন্টেন্ট নিন, যাতে মুছে ফেলা বা যোগ করার জন্য অপেক্ষাধীন টেক্সট ডকুমেন্টে প্রদর্শিত হয়।
  • সমস্ত পরামর্শ গৃহীত হলে কন্টেন্টটি প্রিভিউ হিসেবে দেখুন।
  • সমস্ত পরামর্শ প্রত্যাখ্যান করে, কোনো সাজেশন ছাড়া কন্টেন্টের প্রিভিউ পান।

আপনি যদি SuggestionsViewMode প্রদান না করেন, তাহলে Google Docs API বর্তমান ব্যবহারকারীর বিশেষাধিকার অনুযায়ী একটি ডিফল্ট সেটিং ব্যবহার করে।

পরামর্শ ও সূচক

SuggestionsViewMode গুরুত্বপূর্ণ হওয়ার একটি কারণ হলো, সাজেশন আছে কি নেই তার ওপর নির্ভর করে রেসপন্সের ইনডেক্সগুলো পরিবর্তিত হতে পারে, যেমনটা নিচে দেখানো হয়েছে।

পরামর্শ সহ বিষয়বস্তু পরামর্শ ছাড়া বিষয়বস্তু 
{
 "tabs": [
  {
   "documentTab": {
    "body": {
     "content": [
      {
       "startIndex": 1,
       "endIndex": 31,
       "paragraph": {
        "elements": [
         {
          "startIndex": 1,
          "endIndex": 31,
          "textRun": {
           "content": "Text preceding the suggestion\n",
           "textStyle": {}
          }
         }
        ],
        "paragraphStyle": {
         "namedStyleType": "NORMAL_TEXT",
         "direction": "LEFT_TO_RIGHT"
        }
       }
      },
      {
       "startIndex": 31,
       "endIndex": 51,
       "paragraph": {
        "elements": [
         {
          "startIndex": 31,
          "endIndex": 50,
          "textRun": {
           "content": "Suggested insertion",
           "suggestedInsertionIds": [
            "suggest.vcti8ewm4mww"
           ],
           "textStyle": {}
          }
         },
         {
          "startIndex": 50,
          "endIndex": 51,
          "textRun": {
           "content": "\n",
           "textStyle": {}
          }
         }
        ],
        "paragraphStyle": {
         "namedStyleType": "NORMAL_TEXT",
         "direction": "LEFT_TO_RIGHT"
        }
       }
      },
      {
       "startIndex": 51,
       "endIndex": 81,
       "paragraph": {
        "elements": [
         {
          "startIndex": 51,
          "endIndex": 81,
          "textRun": {
           "content": "Text following the suggestion\n",
           "textStyle": {}
          }
         }
        ],
        "paragraphStyle": {
         "namedStyleType": "NORMAL_TEXT",
         "direction": "LEFT_TO_RIGHT"
        }
       }
      }
     ]
    }
   }
  }
 ]
},


{
 "tabs": [
  {
   "documentTab": {
    "body": {
     "content": [
      {
       "startIndex": 1,
       "endIndex": 31,
       "paragraph": {
        "elements": [
         {
          "startIndex": 1,
          "endIndex": 31,
          "textRun": {
           "content": "Text preceding the suggestion\n",
           "textStyle": {}
          }
         }
        ],
        "paragraphStyle": {
         "namedStyleType": "NORMAL_TEXT",
         "direction": "LEFT_TO_RIGHT"
        }
       }
      },
      {
       "startIndex": 31,
       "endIndex": 32,
       "paragraph": {
        "elements": [
         {
          "startIndex": 31,
          "endIndex": 32,
          "textRun": {
           "content": "\n",
           "textStyle": {}
          }
         }
        ],
        "paragraphStyle": {
         "namedStyleType": "NORMAL_TEXT",
         "direction": "LEFT_TO_RIGHT"
        }
       }
      },
      {
       "startIndex": 32,
       "endIndex": 62,
       "paragraph": {
        "elements": [
         {
          "startIndex": 32,
          "endIndex": 62,
          "textRun": {
           "content": "Text following the suggestion\n",
           "textStyle": {}
          }
         }
        ],
        "paragraphStyle": {
         "namedStyleType": "NORMAL_TEXT",
         "direction": "LEFT_TO_RIGHT"
        }
       }
      }
     ]
    }
   }
  }
 ]
},

উপরের উত্তরে, "Text following the suggestion" লাইনটি সম্বলিত প্যারাগ্রাফটি SuggestionsViewMode ব্যবহার করার ফলে সৃষ্ট পার্থক্যটি দেখায়। এর মান SUGGESTIONS_INLINE সেট করা থাকলে, ParagraphElement এর startIndex ৫১ থেকে শুরু হয় এবং endIndex ৮১-তে শেষ হয়। সাজেশন ছাড়া, startIndex এবং endIndex পরিসর ৩২ থেকে ৬২-এর মধ্যে থাকে।

পরামর্শ ছাড়াই কন্টেন্ট পান

নিম্নলিখিত আংশিক কোড নমুনাটি দেখায় যে কীভাবে SuggestionsViewMode প্যারামিটারটিকে PREVIEW_WITHOUT_SUGGESTIONS এ সেট করে সমস্ত সাজেশন (যদি থাকে) বাতিল করে একটি ডকুমেন্টকে প্রিভিউ হিসাবে পাওয়া যায়।

জাভা 

final string SUGGEST_MODE = "PREVIEW_WITHOUT_SUGGESTIONS";
Document doc =
    service
        .documents()
        .get(DOCUMENT_ID)
        .setIncludeTabsContent(true)
        .setSuggestionsViewMode(SUGGEST_MODE)
        .execute();

পাইথন 

SUGGEST_MODE = "PREVIEW_WITHOUT_SUGGESTIONS"
result = (
  service.documents()
  .get(
      documentId=DOCUMENT_ID,
      includeTabsContent=True,
      suggestionsViewMode=SUGGEST_MODE,
  )
  .execute()
)

SuggestionsViewMode প্যারামিটারটি বাদ দেওয়া, প্যারামিটারের মান হিসেবে DEFAULT_FOR_CURRENT_ACCESS প্রদান করার সমতুল্য।

শৈলীর পরামর্শ

ডকুমেন্টে স্টাইল সাজেশনও থাকতে পারে। এগুলো হলো ফরম্যাটিং এবং উপস্থাপনার জন্য প্রস্তাবিত পরিবর্তন, বিষয়বস্তুর কোনো পরিবর্তন নয়।

টেক্সট সংযোজন বা অপসারণের মতো নয়, এগুলো ইনডেক্সগুলোকে স্থানান্তরিত করে না—যদিও এগুলো একটি TextRun ছোট ছোট খণ্ডে বিভক্ত করতে পারে—বরং প্রস্তাবিত স্টাইল পরিবর্তন সম্পর্কে শুধু টীকা যোগ করে।

এরকম একটি অ্যানোটেশন হলো SuggestedTextStyle , যা দুটি অংশ নিয়ে গঠিত:

  • textStyle বর্ণনা করে যে প্রস্তাবিত পরিবর্তনের পর টেক্সটটি কীভাবে স্টাইল করা হবে, কিন্তু কী পরিবর্তন হয়েছে তা বলে না।

  • textStyleSuggestionState , যা নির্দেশ করে যে সাজেশনটি textStyle এর ফিল্ডগুলোকে কীভাবে পরিবর্তন করবে।

আপনি নিম্নলিখিত ডকুমেন্ট ট্যাবের উদ্ধৃতাংশে এটি দেখতে পারেন, যেখানে একটি প্রস্তাবিত শৈলী পরিবর্তন অন্তর্ভুক্ত রয়েছে:

[01] "paragraph": {
[02]    "elements": [
[03]        {
[04]            "endIndex": 106,
[05]            "startIndex": 82,
[06]            "textRun": {
[07]                "content": "Some text that does not ",
[08]                "textStyle": {}
[09]            }
[10]        },
[11]        {
[12]            "endIndex": 115,
[13]            "startIndex": 106,
[14]            "textRun": {
[15]                "content": "initially",
[16]                "suggestedTextStyleChanges": {
[17]                    "suggest.xymysbs9zldp": {
[18]                        "textStyle": {
[19]                            "backgroundColor": {},
[20]                            "baselineOffset": "NONE",
[21]                            "bold": true,
[22]                            "fontSize": {
[23]                                "magnitude": 11,
[24]                                "unit": "PT"
[25]                            },
[26]                            "foregroundColor": {
[27]                                "color": {
[28]                                    "rgbColor": {}
[29]                                }
[30]                            },
[31]                            "italic": false,
[32]                            "smallCaps": false,
[33]                            "strikethrough": false,
[34]                            "underline": false
[35]                        },
[36]                        "textStyleSuggestionState": {
[37]                            "boldSuggested": true,
[38]                            "weightedFontFamilySuggested": true
[39]                        }
[40]                    }
[41]                },
[42]                "textStyle": {
[43]                    "italic": true
[44]                }
[45]            }
[46]        },
[47]        {
[48]            "endIndex": 143,
[49]            "startIndex": 115,
[50]            "textRun": {
[51]                "content": " contain any boldface text.\n",
[52]                "textStyle": {}
[53]            }
[54]        }
[55]    ],
[56]    "paragraphStyle": {
[57]        "direction": "LEFT_TO_RIGHT",
[58]        "namedStyleType": "NORMAL_TEXT"
[59]    }
[60] }

উপরের নমুনাটিতে, অনুচ্ছেদটি ৩টি টেক্সট রান নিয়ে গঠিত, যা যথাক্রমে ৬, ১৪ এবং ৫০ নম্বর লাইন থেকে শুরু হয়েছে। মাঝের টেক্সট রানটি পরীক্ষা করুন:

  • লাইন ১৬: একটি suggestedTextStyleChanges অবজেক্ট আছে।
  • লাইন ১৮: textStyle বিভিন্ন ফরম্যাটিং নির্দিষ্ট করে।
  • লাইন ৩৬: textStyleSuggestionState আপনাকে জানায় যে, এই স্পেসিফিকেশনের শুধুমাত্র বোল্ড অংশটিই সাজেশন ছিল।
  • লাইন ৪২: এই টেক্সট রানের ইটালিক স্টাইলিং বর্তমান ডকুমেন্টেরই একটি অংশ (এবং সাজেশন দ্বারা প্রভাবিত নয়)।

শুধুমাত্র textStyleSuggestionState এ true সেট করা স্টাইল ফিচারগুলোই সাজেশনের অংশ।