Method: indexing.datasources.items.index

Item ACL, মেটাডেটা এবং বিষয়বস্তু আপডেট করে। এটি উপস্থিত না থাকলে এটি Item সন্নিবেশ করবে। এই পদ্ধতি আংশিক আপডেট সমর্থন করে না. ক্লাউড সার্চ ইনডেক্সে কোনও প্রদত্ত মান ছাড়াই ক্ষেত্রগুলি সাফ করা হয়।

এই API কার্যকর করার জন্য একটি প্রশাসক বা পরিষেবা অ্যাকাউন্ট প্রয়োজন৷ ব্যবহৃত পরিষেবা অ্যাকাউন্টটি সংশ্লিষ্ট ডেটা উৎসে সাদা তালিকাভুক্ত।

HTTP অনুরোধ

POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
item.name

string

আইটেমের নাম। বিন্যাস: datasources/{sourceId}/items/{itemId}

এটি একটি প্রয়োজনীয় ক্ষেত্র। সর্বাধিক দৈর্ঘ্য 1536 অক্ষর।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "item": {
    "name": string,
    "acl": {
      "inheritAclFrom": string,
      "aclInheritanceType": enum (ItemAcl.AclInheritanceType),
      "readers": [
        {
          object (Principal)
        }
      ],
      "deniedReaders": [
        {
          object (Principal)
        }
      ],
      "owners": [
        {
          object (Principal)
        }
      ]
    },
    "metadata": {
      "title": string,
      "sourceRepositoryUrl": string,
      "containerName": string,
      "objectType": string,
      "createTime": string,
      "updateTime": string,
      "interactions": [
        {
          object (Interaction)
        }
      ],
      "contentLanguage": string,
      "mimeType": string,
      "searchQualityMetadata": {
        object (SearchQualityMetadata)
      },
      "keywords": [
        string
      ],
      "hash": string,
      "contextAttributes": [
        {
          object (ContextAttribute)
        }
      ]
    },
    "structuredData": {
      "object": {
        object (StructuredDataObject)
      },
      "hash": string
    },
    "content": {
      "contentFormat": enum (ItemContent.ContentFormat),
      "hash": string,

      // Union field content can be only one of the following:
      "inlineContent": string,
      "contentDataRef": {
        object (UploadItemRef)
      }
      // End of list of possible types for union field content.
    },
    "version": string,
    "status": {
      "code": enum (ItemStatus.Code),
      "processingErrors": [
        {
          object (ProcessingError)
        }
      ],
      "repositoryErrors": [
        {
          object (RepositoryError)
        }
      ]
    },
    "queue": string,
    "payload": string,
    "itemType": enum (Item.ItemType)
  },
  "connectorName": string,
  "mode": enum (RequestMode.Mode),
  "debugOptions": {
    object (DebugOptions)
  },
  "indexItemOptions": {
    object (IndexItemOptions)
  }
}
ক্ষেত্র
item.acl

object ( ItemAcl )

এই আইটেম জন্য অ্যাক্সেস নিয়ন্ত্রণ তালিকা.

item.metadata

object ( ItemMetadata )

মেটাডেটা তথ্য.

item.structuredData

object ( ItemStructuredData )

আইটেমের জন্য স্ট্রাকচার্ড ডেটা যা ডেটা উৎসের স্কিমাতে নিবন্ধিত অবজেক্টের সংজ্ঞার সাথে সঙ্গতিপূর্ণ হওয়া উচিত।

item.content

object ( ItemContent )

আইটেম বিষয়বস্তু সূচিবদ্ধ করা এবং পাঠ্য অনুসন্ধানযোগ্য করা.

item.version

string ( bytes format)

প্রয়োজন। ইনডেক্সিং সিস্টেম ডাটাসোর্স থেকে সংস্করণটিকে একটি বাইট স্ট্রিং হিসাবে সংরক্ষণ করে এবং আভিধানিক ক্রম ব্যবহার করে সারিবদ্ধ আইটেমের সংস্করণের সাথে সূচকের আইটেম সংস্করণের তুলনা করে।

ক্লাউড সার্চ ইনডেক্সিং বর্তমানে ইন্ডেক্স করা আইটেমের সংস্করণের চেয়ে কম বা সমান সংস্করণের মান সহ কোনো সারিবদ্ধ আইটেমকে সূচী বা মুছে ফেলবে না। এই ক্ষেত্রের জন্য সর্বাধিক দৈর্ঘ্য 1024 বাইট।

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

একটি base64-এনকোডেড স্ট্রিং।

item.status

object ( ItemStatus )

আইটেম অবস্থা. আউটপুট শুধুমাত্র ক্ষেত্র.

item.queue

string

এই আইটেমটি সারিবদ্ধ। সর্বাধিক দৈর্ঘ্য 100 অক্ষর।

item.payload

string ( bytes format)

অতিরিক্ত রাষ্ট্র সংযোগকারী এই আইটেম জন্য সংরক্ষণ করতে পারেন. সর্বাধিক দৈর্ঘ্য 10000 বাইট।

একটি base64-এনকোডেড স্ট্রিং।

item.itemType

enum ( Item.ItemType )

এই আইটেম জন্য টাইপ.

connectorName

string

এই কল করার সংযোগকারীর নাম।

বিন্যাস: datasources/{sourceId}/connectors/{ID}

mode

enum ( RequestMode.Mode )

প্রয়োজন। এই অনুরোধের জন্য RequestMode.

debugOptions

object ( DebugOptions )

সাধারণ ডিবাগ বিকল্প।

indexItemOptions

object ( IndexItemOptions )

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

সফল হলে, প্রতিক্রিয়া বডিতে Operation একটি উদাহরণ থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।

IndexItemOptions

JSON প্রতিনিধিত্ব
{
  "allowUnknownGsuitePrincipals": boolean
}
ক্ষেত্র
allowUnknownGsuitePrincipals

boolean

ইন্ডেক্সের অনুরোধে Google Workspace-এর প্রিন্সিপ্যালদের অনুমতি দেওয়া উচিত কিনা তা উল্লেখ করে যেগুলি বিদ্যমান নেই বা মুছে ফেলা হয়েছে।