কানেক্টর এপিআই-এর জন্য কোড নমুনা

API বৈশিষ্ট্য সম্পর্কে তথ্যের জন্য কানেক্টরস API দেখুন।

এই পৃষ্ঠার সমস্ত অনুরোধে নিম্নলিখিত ভেরিয়েবলগুলো ব্যবহৃত হয়:

• $TOKEN - OAuth 2.0 টোকেন
• $CUSTOMER - গ্রাহকের আইডি অথবা আক্ষরিক অর্থে my_customer
• $PAGE_TOKEN - পূর্ববর্তী পৃষ্ঠার প্রতিক্রিয়া থেকে প্রাপ্ত পৃষ্ঠা টোকেন
• $CONNECTOR_CONFIG_ID - কানেক্টর কনফিগের আইডি। তৈরি হওয়া আইডিগুলো বড় হাতের অক্ষরে লেখা UUID আকারে থাকে (উদাহরণস্বরূপ, 550E8400-E29B-41D4-A716-446655440000 )।

সংযোগকারী কনফিগারেশন তালিকাভুক্ত করুন

আপনার গ্রাহক ডোমেনের জন্য কানেক্টর কনফিগারেশন তালিকাভুক্ত করতে, list মেথডটি ব্যবহার করুন। ফলাফল জুড়ে পেজিনেট করার সময় আপনি ঐচ্ছিকভাবে page_size (বা pageSize ) এবং page_token (বা pageToken ) কোয়েরি প্যারামিটার প্রদান করতে পারেন:

• page_size / pageSize : ফেরত দেওয়া কানেক্টর কনফিগারেশনের সর্বোচ্চ সংখ্যা। নির্দিষ্ট না করা হলে ডিফল্ট পেজ সাইজ হয় ৫০ এবং এর সর্বোচ্চ মান ১০০।
• page_token / pageToken : পূর্ববর্তী list আহ্বান থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন।

অনুরোধ

curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/connectorConfigs?page_size=50&page_token=$PAGE_TOKEN"

প্রতিক্রিয়া

{
  "connectorConfigs": [
    {
      "name": "customers/my_customer/connectorConfigs/550E8400-E29B-41D4-A716-446655440000",
      "displayName": "Configuration 1",
      "type": "REPORTING",
      "details": {
        "googleSecOpsConfig": {
          "host": "example.googlesecops.com",
          "reportingSettings": {
            "enabledDefaultEvents": [
              "ALL_DEFAULT_EVENTS"
            ],
            "enabledOptInEvents": [
              "PASSWORD_BREACH_EVENT",
              "URL_NAVIGATION_EVENT"
            ],
            "enabledDeviceEvents": [
              "ALL_DEVICE_EVENTS"
            ]
          }
        }
      },
      "status": {
        "state": "ENABLED"
      }
    }
  ],
  "nextPageToken": "<next_page_token>"
}

একটি সংযোগকারী কনফিগারেশন পান

আইডি দ্বারা কোনো নির্দিষ্ট কানেক্টর কনফিগারেশন পুনরুদ্ধার করতে, get মেথডটি ব্যবহার করুন।

অনুরোধ

curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/connectorConfigs/$CONNECTOR_CONFIG_ID"

প্রতিক্রিয়া

{
  "name": "customers/my_customer/connectorConfigs/550E8400-E29B-41D4-A716-446655440000",
  "displayName": "Configuration 1",
  "type": "REPORTING",
  "details": {
    "googleSecOpsConfig": {
      "host": "example.googlesecops.com",
      "reportingSettings": {
        "enabledDefaultEvents": [
          "ALL_DEFAULT_EVENTS"
        ],
        "enabledOptInEvents": [
          "PASSWORD_BREACH_EVENT",
          "URL_NAVIGATION_EVENT"
        ],
        "enabledDeviceEvents": [
          "ALL_DEVICE_EVENTS"
        ]
      }
    }
  },
  "status": {
    "state": "ENABLED"
  }
}

একটি সংযোগকারী কনফিগারেশন তৈরি করুন

আপনার কাস্টমার ডোমেনের জন্য একটি নতুন কানেক্টর কনফিগারেশন তৈরি করতে, ` create মেথডটি ব্যবহার করুন। আপনি চাইলে ` connector_config_id (বা connectorConfigId ) কোয়েরি প্যারামিটার সেট করে একটি কাস্টম আইডি প্রদান করতে পারেন। যদি কোনো আইডি প্রদান করা না হয়, তাহলে সার্ভার দ্বারা একটি বড় হাতের অক্ষরে লেখা UUID তৈরি করা হবে।

অনুরোধ

curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "Configuration 1",
    "type": "REPORTING",
    "details": {
      "googleSecOpsConfig": {
        "apiKey": "api-key",
        "host": "example.googlesecops.com",
        "reportingSettings": {
          "enabledDefaultEvents": [
            "ALL_DEFAULT_EVENTS"
          ],
          "enabledOptInEvents": [
            "PASSWORD_BREACH_EVENT"
          ],
          "enabledDeviceEvents": [
            "ALL_DEVICE_EVENTS"
          ]
        }
      }
    }
  }' \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/connectorConfigs?connector_config_id=$CONNECTOR_CONFIG_ID"

প্রতিক্রিয়া

{
  "name": "customers/my_customer/connectorConfigs/550E8400-E29B-41D4-A716-446655440000",
  "displayName": "Configuration 1",
  "type": "REPORTING",
  "details": {
    "googleSecOpsConfig": {
      "host": "example.googlesecops.com",
      "reportingSettings": {
        "enabledDefaultEvents": [
          "ALL_DEFAULT_EVENTS"
        ],
        "enabledOptInEvents": [
          "PASSWORD_BREACH_EVENT"
        ],
        "enabledDeviceEvents": [
          "ALL_DEVICE_EVENTS"
        ]
      }
    }
  },
  "status": {
    "state": "ENABLED"
  }
}

একটি সংযোগকারী কনফিগারেশন আপডেট করুন

একটি কানেক্টরের কনফিগারেশন নিম্নলিখিত উপায়গুলোর যেকোনো একটিতে আপডেট করা যেতে পারে:

• আপডেট মাস্ক নেই : যদি কোনো updateMask কোয়েরি প্যারামিটার প্রদান করা না হয়, তাহলে অনুরোধে সেট করা সমস্ত ফিল্ড আপডেট করা হবে।
• আপডেট মাস্ক সহ : যদি একটি updateMask কোয়েরি প্যারামিটার নির্দিষ্ট করা থাকে, তবে শুধুমাত্র মাস্কে তালিকাভুক্ত ফিল্ডগুলিই আপডেট করা হবে।
• * এর সাথে সঙ্গতিপূর্ণ আপডেট মাস্কের ক্ষেত্রে : যদি updateMask * এ সেট করা থাকে, তাহলে আপডেটটিকে একটি সম্পূর্ণ প্রতিস্থাপন (তৈরির সমতুল্য) হিসাবে গণ্য করা হয়।

উদাহরণ ১: শুধুমাত্র displayName লক্ষ্য করে মাস্ক আপডেট করুন

এই অপশনে, updateMask=displayName প্রদান করলে বডিতে অতিরিক্ত ফিল্ড সরবরাহ করা হলেও শুধুমাত্র displayName আপডেট হবে।

অনুরোধ

curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "Updated name"
  }' \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/connectorConfigs/$CONNECTOR_CONFIG_ID?updateMask=displayName"

প্রতিক্রিয়া

{
  "name": "customers/my_customer/connectorConfigs/550E8400-E29B-41D4-A716-446655440000",
  "displayName": "Updated name",
  "type": "REPORTING",
  "details": {
    "googleSecOpsConfig": {
      "host": "example.googlesecops.com",
      "reportingSettings": {
        "enabledDefaultEvents": [
          "BROWSER_EXTENSION_INSTALL_EVENT"
        ],
        "enabledOptInEvents": [
          "PASSWORD_BREACH_EVENT"
        ],
        "enabledDeviceEvents": [
          "LOGIN_LOGOUT_EVENT"
        ]
      }
    }
  },
  "status": {
    "state": "ENABLED"
  }
}

উদাহরণ ২: কোনো আপডেট মাস্ক নেই (অনুরোধের সমস্ত ফিল্ড আপডেট করে)

অনুরোধের কোয়েরি স্ট্রিং থেকে updateMask বাদ দেওয়া হলে, JSON পেলোডে প্রদত্ত সমস্ত ফিল্ড আপডেট করা হয়।

অনুরোধ

curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "Updated again",
    "details": {
      "googleSecOpsConfig": {
        "reportingSettings": {
          "enabledDefaultEvents": [
            "BROWSER_EXTENSION_INSTALL_EVENT",
            "CONTENT_TRANSFER_EVENT",
            "CONTENT_UNSCANNED_EVENT",
            "DATA_ACCESS_CONTROL_EVENT",
            "MALWARE_TRANSFER_EVENT"
          ]
        }
      }
    }
  }' \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/connectorConfigs/$CONNECTOR_CONFIG_ID"

প্রতিক্রিয়া

{
  "name": "customers/my_customer/connectorConfigs/550E8400-E29B-41D4-A716-446655440000",
  "displayName": "Updated again",
  "type": "REPORTING",
  "details": {
    "googleSecOpsConfig": {
      "host": "example.googlesecops.com",
      "reportingSettings": {
        "enabledDefaultEvents": [
          "BROWSER_EXTENSION_INSTALL_EVENT",
          "CONTENT_TRANSFER_EVENT",
          "CONTENT_UNSCANNED_EVENT",
          "DATA_ACCESS_CONTROL_EVENT",
          "MALWARE_TRANSFER_EVENT"
        ],
        "enabledOptInEvents": [
          "PASSWORD_BREACH_EVENT"
        ],
        "enabledDeviceEvents": [
          "ALL_DEVICE_EVENTS"
        ]
      }
    }
  },
  "status": {
    "state": "ENABLED"
  }
}

উদাহরণ ৩: * এর মাস্ক আপডেট করুন (সম্পূর্ণ প্রতিস্থাপন)

updateMask=* সেট করলে তা বিদ্যমান কনফিগারেশনকে রিকোয়েস্ট বডিতে দেওয়া পেলোড দ্বারা সম্পূর্ণরূপে প্রতিস্থাপন করে।

অনুরোধ

curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "New Updated Display Name",
    "type": "REPORTING",
    "details": {
      "googleSecOpsConfig": {
        "apiKey": "api-key",
        "host": "example.googlesecops.com",
        "reportingSettings": {
          "enabledOptInEvents": [
            "PASSWORD_BREACH_EVENT"
          ]
        }
      }
    }
  }' \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/connectorConfigs/$CONNECTOR_CONFIG_ID?updateMask=*"

প্রতিক্রিয়া

{
  "name": "customers/my_customer/connectorConfigs/550E8400-E29B-41D4-A716-446655440000",
  "displayName": "New Updated Display Name",
  "type": "REPORTING",
  "details": {
    "googleSecOpsConfig": {
      "host": "example.googlesecops.com",
      "reportingSettings": {
        "enabledOptInEvents": [
          "PASSWORD_BREACH_EVENT"
        ]
      }
    }
  },
  "status": {
    "state": "ENABLED"
  }
}

একটি সংযোগকারী কনফিগারেশন মুছুন

কানেক্টর কনফিগারেশন মুছে ফেলার জন্য, delete মেথডটি ব্যবহার করুন।

অনুরোধ

curl -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/connectorConfigs/$CONNECTOR_CONFIG_ID"

প্রতিক্রিয়া

{}