Google ড্রাইভ ইভেন্টগুলিতে সদস্যতা নিন

Google Workspace Events API ব্যবহার করে আপনার অ্যাপ সাবস্ক্রাইব করতে পারে এমন Google Drive ইভেন্টগুলি এই পৃষ্ঠায় বর্ণনা করা হয়েছে। আপনার কোন ধরনের ইভেন্ট প্রয়োজন তা স্থির করার পরে, ড্রাইভ থেকে ইভেন্টগুলি গ্রহণ শুরু করতে একটি সদস্যতা তৈরি করুন ৷

ড্রাইভের জন্য অ্যাপ্লিকেশানগুলি তৈরি করার বিষয়ে আরও জানতে, Google ড্রাইভ API ওভারভিউ দেখুন৷

সমর্থিত ড্রাইভ ইভেন্ট

Google Workspace সাবস্ক্রিপশন আপনাকে Drive-এ নিম্নলিখিত ধরনের পরিবর্তনগুলি সম্পর্কে ইভেন্টগুলি পেতে দেয়:

• একটি ফাইল হল:
  • একটি ফোল্ডার বা শেয়ার্ড ড্রাইভে যোগ করা হয়েছে৷
  • একটি ফোল্ডার বা শেয়ার্ড ড্রাইভে সরানো হয়েছে৷
  • সম্পাদিত বা একটি নতুন সংশোধন আপলোড করা হয়.
  • ট্র্যাশ বা ট্র্যাশ থেকে সরানো.
• একটি ফাইলে একটি অ্যাক্সেস প্রস্তাব তৈরি বা সমাধান করা হয়।

আপনি ইভেন্টের জন্য নিরীক্ষণ করতে পারেন যে সম্পদ

ইভেন্টগুলি পেতে, আপনি নিরীক্ষণের জন্য একটি ড্রাইভ সংস্থান নির্দিষ্ট করেন, যাকে সাবস্ক্রিপশনের লক্ষ্য সংস্থান বলা হয়।

Google Workspace Events API Drive-এর জন্য নিম্নলিখিত টার্গেট রিসোর্স সমর্থন করে:

সদস্যতা তৈরির জন্য ইভেন্টের ধরন

আপনি যখন ড্রাইভ রিসোর্সে সাবস্ক্রিপশন তৈরি করেন, তখন আপনি কোন ধরনের ইভেন্টগুলি পেতে চান তা নির্দিষ্ট করতে আপনি eventTypes[] ফিল্ড ব্যবহার করেন। ইভেন্টের ধরনগুলি CloudEvents স্পেসিফিকেশন অনুযায়ী ফর্ম্যাট করা হয়, যেমন google.workspace. APPLICATION . RESOURCE . VERSION . ACTION

উদাহরণস্বরূপ, একটি ফোল্ডার বা শেয়ার্ড ড্রাইভে তৈরি করা ফাইল সম্পর্কে ইভেন্টগুলি পেতে, আপনি ফাইলটিকে টার্গেট রিসোর্স এবং ইভেন্টের ধরনটি google.workspace.drive.file.v3.created হিসাবে নির্দিষ্ট করুন। একটি ফাইলে একটি অ্যাক্সেস প্রস্তাব তৈরি করা সম্পর্কে ইভেন্টগুলি পেতে, আপনি লক্ষ্য সংস্থান হিসাবে অ্যাক্সেস প্রস্তাব এবং ইভেন্টের ধরনটি google.workspace.drive.accessproposal.v3.created হিসাবে নির্দিষ্ট করুন। ইভেন্টগুলি কীভাবে কাজ করে সে সম্পর্কে আরও জানতে, Google Workspace ইভেন্টগুলির কাঠামো দেখুন।

নিম্নলিখিত টেবিলটি ড্রাইভ সংস্থানগুলির সদস্যতাগুলির জন্য কোন ইভেন্ট প্রকারগুলি সমর্থিত তা প্রদর্শন করে:

ইভেন্ট ডেটা

এই বিভাগটি ড্রাইভে ইভেন্টের জন্য ইভেন্ট ডেটা এবং উদাহরণ পেলোডগুলি বর্ণনা করে৷

আপনার Google Workspace সাবস্ক্রিপশন যখন Drive থেকে একটি ইভেন্ট পায়, তখন data ফিল্ডে ইভেন্টের পেলোড থাকে। এই পেলোডে পরিবর্তন করা Google Workspace রিসোর্স সম্পর্কে তথ্য রয়েছে। উদাহরণস্বরূপ, আপনি যদি ফাইল ইভেন্টগুলিতে সদস্যতা নিয়ে থাকেন তবে এই ইভেন্টগুলির জন্য পেলোডে file রিসোর্স সম্পর্কে তথ্য রয়েছে যা পরিবর্তিত হয়েছে৷

ইভেন্ট পেলোডে সম্পদ তথ্য

আপনি যখন একটি সাবস্ক্রিপশন তৈরি করেন, তখন আপনি নির্দিষ্ট করতে পারেন যে আপনি পেলোডটি সংস্থান সম্পর্কে বিশদ বিবরণ অন্তর্ভুক্ত করতে চান, বা শুধুমাত্র সম্পদের নাম। উদাহরণস্বরূপ, আপনি যদি ড্রাইভে ফাইল সম্পর্কে ইভেন্টগুলি পেতে চান, আপনি ইভেন্ট পেলোডে files রিসোর্সের কোন ক্ষেত্রগুলি পেতে চান তা নির্দিষ্ট করতে পারেন৷

নিম্নলিখিত সারণীটি ড্রাইভ সংস্থানের সদস্যতার জন্য JSON পেলোডগুলির উদাহরণ প্রদান করে৷ ফাইল আইডিতে অক্ষর, সংখ্যা এবং files/^[01][0-9a-zA-Z_-]+$/ । উদাহরণস্বরূপ, files/1aaabbbAAABBB111222-_ । সাবস্ক্রিপশন প্রাপ্ত প্রতিটি ইভেন্টের জন্য, পেলোডটি ইভেন্টের data ক্ষেত্রে উপস্থিত হয়:

{
  "fileCreatedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileCreatedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "fileMovedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileMovedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "fileContentChangedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileContentChangedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "fileDeletedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileDeletedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "fileTrashedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileTrashedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "fileUntrashedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileUntrashedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "accessProposalCreatedEvent": {
    "accessProposal": [
      {
        "file_id": "FILE_ID",
        "proposalId": "PROPOSAL_ID",
        "recipientEmailAddress": "63",
        "requesterEmailAddress": "application/vnd.google-apps.document",
        "requestMessage": "grant me access to this file",
        "rolesAndViews": [
          {
            "role": "writer",
            "view": "published"
          }
        ]
      }
    ]
  }
}
      

{
  "accessProposalCreatedEvent": {
    "accessProposal": [
      {
        "proposalId": "PROPOSAL_ID"
      }
    ]
  }
}
      

{
  "accessProposalResolvedEvent": {
    "accessProposal": [
      {
        "file_id": "FILE_ID",
        "proposalId": "PROPOSAL_ID",
        "recipientEmailAddress": "63",
        "requesterEmailAddress": "application/vnd.google-apps.document",
        "requestMessage": "resolve access to this file",
        "rolesAndViews": [
          {
            "role": "writer",
            "view": "published"
          }
        ]
      }
    ]
  }
}
      

{
  "accessProposalResolvedEvent": {
    "accessProposal": [
      {
        "proposalId": "PROPOSAL_ID"
      }
    ]
  }
}
      

• যখন DriveOptions includeDescendants বুলিয়ান ক্ষেত্রটি true হয়, তখন শেয়ার্ড ড্রাইভ এবং ফোল্ডারে ড্রাইভ সাবস্ক্রিপশন সর্বদা একটি ইভেন্ট প্রেরণ করে, এমনকি যে ফাইলটি ইভেন্টটিকে ট্রিগার করেছে সেটি ড্রাইভ সাবস্ক্রিপশনের জন্য ব্যবহৃত ফোল্ডারের নীচে অনেক স্তর নেস্ট করা থাকলেও৷
• যদিও আপনি একটি ফোল্ডারে একটি সাবস্ক্রিপশন তৈরি করেছেন, আপনি ফাইল অনুক্রমের মধ্যে সমস্ত ইভেন্ট নাও পেতে পারেন কারণ ব্যবহারকারী বা অ্যাপ্লিকেশনটিকে সেগুলিতে অ্যাক্সেস দেওয়া নাও হতে পারে৷ এই ক্ষেত্রে, সাবস্ক্রিপশন সক্রিয় থাকে তবে আপনি যে সংস্থানগুলিতে অ্যাক্সেস নেই তার জন্য আপনি কোনও ইভেন্ট পাবেন না।
• সাবস্ক্রিপশন সমস্ত ফাইল এবং ফোল্ডারে ইভেন্টের জন্য সমর্থিত কিন্তু শেয়ার্ড ড্রাইভের রুট ফোল্ডারে নয়। সাবস্ক্রিপশন শুধুমাত্র শেয়ার্ড ড্রাইভের মধ্যে থাকা ফাইল এবং ফোল্ডারগুলির জন্য সমর্থিত। শেয়ার্ড ড্রাইভের রুট ফোল্ডারে সরাসরি করা পরিবর্তন ইভেন্ট ট্রিগার করবে না।
• সাবস্ক্রিপশন অনুমোদনকারী ব্যবহারকারীর অবশ্যই ফাইলটিতে অনুমতি থাকতে হবে যা তারা সদস্যতা নিয়েছে।
• সাবস্ক্রিপশন শুধুমাত্র সেই রিসোর্সের জন্য ইভেন্ট গ্রহণ করে যেখানে ব্যবহারকারীর Google Workspace অ্যাকাউন্ট বা Google অ্যাকাউন্টের মাধ্যমে অ্যাক্সেস থাকে।

সম্পর্কিত বিষয়

• Google Workspace ইভেন্ট API ওভারভিউ
• Google Workspace ইভেন্টের কাঠামো
• Google Workspace Events API স্কোপ বেছে নিন
• Google Drive API স্কোপগুলি বেছে নিন