Method: accounts.searchChangeHistoryEvents

নির্দিষ্ট ফিল্টার সেট ব্যবহার করে কোনো অ্যাকাউন্ট বা তার অধীনস্থ অ্যাকাউন্টগুলোর সমস্ত পরিবর্তন অনুসন্ধান করে।

শুধুমাত্র এপিআই দ্বারা সমর্থিত পরিবর্তনগুলোর একটি উপসেট ফেরত দেয়। ইউআই অতিরিক্ত পরিবর্তনও ফেরত দিতে পারে।

HTTP অনুরোধ

POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents

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

পথের পরামিতি

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

string

আবশ্যক। যে অ্যাকাউন্ট রিসোর্সের পরিবর্তন ইতিহাসের রিসোর্স ফেরত দিতে হবে। ফরম্যাট: accounts/{account}

উদাহরণ: accounts/100

অনুরোধকারী শরীর

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

JSON উপস্থাপনা 
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
ক্ষেত্র
property

string

ঐচ্ছিক। একটি চাইল্ড প্রপার্টির জন্য রিসোর্সের নাম। যদি সেট করা থাকে, তবে শুধুমাত্র এই প্রপার্টি বা এর চাইল্ড রিসোর্সগুলিতে করা পরিবর্তনগুলি ফেরত দেওয়া হবে। ফরম্যাট: properties/{propertyId}

উদাহরণ: properties/100

resourceType[]

enum ( ChangeHistoryResourceType )

ঐচ্ছিক। সেট করা থাকলে, শুধুমাত্র সেই পরিবর্তনগুলি ফেরত দেওয়া হবে যেগুলি এমন একটি রিসোর্সের জন্য যা এই প্রকারগুলির মধ্যে অন্তত একটির সাথে মেলে।

action[]

enum ( ActionType )

ঐচ্ছিক। সেট করা থাকলে, শুধুমাত্র সেই পরিবর্তনগুলি ফেরত দেওয়া হবে যা এই ধরণের এক বা একাধিক ক্রিয়াকলাপের সাথে মেলে।

actorEmail[]

string

ঐচ্ছিক। সেট করা থাকলে, শুধুমাত্র সেই পরিবর্তনগুলিই দেখানো হবে যা এই তালিকার কোনো ব্যবহারকারী করেছেন।

earliestChangeTime

string ( Timestamp format)

ঐচ্ছিক। সেট করা থাকলে, শুধুমাত্র এই সময়ের পরে (এই সময় সহ) করা পরিবর্তনগুলি ফেরত দেওয়া হবে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

latestChangeTime

string ( Timestamp format)

ঐচ্ছিক। সেট করা থাকলে, শুধুমাত্র এই সময়ের (অন্তর্ভুক্ত) আগে করা পরিবর্তনগুলোই ফেরত দেওয়া হবে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

pageSize

integer

ঐচ্ছিক। ফেরত দেওয়া ChangeHistoryEvent আইটেমের সর্বোচ্চ সংখ্যা। নির্দিষ্ট না করা হলে, সর্বাধিক ৫০টি আইটেম ফেরত দেওয়া হবে। সর্বোচ্চ মান হলো ২০০ (এর চেয়ে বেশি মান সর্বোচ্চ মানে রূপান্তরিত হবে)।

মনে রাখবেন যে পরিষেবাটি এই নির্দিষ্ট মানের চেয়ে কম আইটেম সহ একটি পৃষ্ঠা ফেরত দিতে পারে (এমনকি শূন্যও হতে পারে), এবং তারপরেও অতিরিক্ত পৃষ্ঠা থাকতে পারে। আপনি যদি একটি নির্দিষ্ট সংখ্যক আইটেম চান, তাহলে প্রয়োজনীয় সংখ্যাটি না পাওয়া পর্যন্ত আপনাকে pageToken ব্যবহার করে অতিরিক্ত পৃষ্ঠার জন্য অনুরোধ করতে থাকতে হবে।

pageToken

string

ঐচ্ছিক। একটি পেজ টোকেন, যা পূর্ববর্তী accounts.searchChangeHistoryEvents কল থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এটি প্রদান করুন। পেজিনেশন করার সময়, accounts.searchChangeHistoryEvents এ প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই সেই কলের সাথে মিলতে হবে যা পেজ টোকেনটি প্রদান করেছে।

প্রতিক্রিয়া সংস্থা

SearchAccounts RPC-এর প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
changeHistoryEvents[]

object ( ChangeHistoryEvent )

যে ফলাফলগুলো ফোনকারীর জন্য সহজলভ্য ছিল।

nextPageToken

string

একটি টোকেন, যা পরবর্তী পৃষ্ঠা আনার জন্য pageToken হিসেবে পাঠানো যেতে পারে। এই ক্ষেত্রটি বাদ দিলে, পরবর্তী কোনো পৃষ্ঠা থাকবে না।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/analytics.edit

ChangeHistoryResourceType

যেসব রিসোর্সের পরিবর্তন চেঞ্জ হিস্ট্রি থেকে ফেরত পাওয়া যেতে পারে, তাদের প্রকারভেদ।

এনাম
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED রিসোর্সের ধরণ অজানা বা অনির্দিষ্ট।
ACCOUNT অ্যাকাউন্ট রিসোর্স
PROPERTY সম্পত্তি সম্পদ
GOOGLE_SIGNALS_SETTINGS GoogleSignalsSettings রিসোর্স
CONVERSION_EVENT রূপান্তর ইভেন্ট রিসোর্স
MEASUREMENT_PROTOCOL_SECRET পরিমাপ প্রোটোকল গোপন সম্পদ
CUSTOM_DIMENSION কাস্টমডাইমেনশন রিসোর্স
CUSTOM_METRIC কাস্টমমেট্রিক রিসোর্স
DATA_RETENTION_SETTINGS ডেটা রিটেনশন সেটিংস রিসোর্স
DATA_STREAM ডেটাস্ট্রিম রিসোর্স
ATTRIBUTION_SETTINGS অ্যাট্রিবিউশন সেটিংস রিসোর্স

অ্যাকশন টাইপ

যেসব ধরনের কার্যকলাপ কোনো রিসোর্সকে পরিবর্তন করতে পারে।

এনাম
ACTION_TYPE_UNSPECIFIED ক্রিয়ার ধরণ অজানা বা অনির্দিষ্ট।
CREATED এই পরিবর্তনে রিসোর্সটি তৈরি করা হয়েছে।
UPDATED এই পরিবর্তনে রিসোর্সটি আপডেট করা হয়েছে।
DELETED এই পরিবর্তনে রিসোর্সটি মুছে ফেলা হয়েছে।

ChangeHistoryEvent

একটি গুগল অ্যানালিটিক্স অ্যাকাউন্ট বা এর অধীনস্থ প্রপার্টিগুলোর মধ্যে একই কারণে ঘটা একাধিক পরিবর্তন। এর সাধারণ কারণগুলো হলো গুগল অ্যানালিটিক্স ইউআই-তে করা আপডেট, কাস্টমার সাপোর্টের পক্ষ থেকে আসা পরিবর্তন, অথবা গুগল অ্যানালিটিক্স সিস্টেমের স্বয়ংক্রিয় পরিবর্তন।

JSON উপস্থাপনা 
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
ক্ষেত্র
id

string

এই পরিবর্তন ইতিহাস ইভেন্টের আইডি। এই আইডিটি গুগল অ্যানালিটিক্স জুড়ে অনন্য।

changeTime

string ( Timestamp format)

যে সময়ে পরিবর্তনটি করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

actorType

enum ( ActorType )

যে ধরনের অভিনেতা এই পরিবর্তনটি এনেছেন।

userActorEmail

string

যে গুগল অ্যাকাউন্টটি পরিবর্তনটি করেছে তার ইমেল ঠিকানা। যদি অ্যাক্টর ফিল্ডটি USER-এ সেট করা থাকে, তবে এটি একটি বৈধ ইমেল ঠিকানা হবে, অন্যথায় এটি খালি থাকবে। মুছে ফেলা গুগল অ্যাকাউন্টগুলো একটি ত্রুটির কারণ হবে।

changesFiltered

boolean

যদি সত্য হয়, তাহলে ফেরত আসা পরিবর্তনের তালিকাটি ফিল্টার করা হয়েছে এবং এটি এই ইভেন্টে ঘটা সমস্ত পরিবর্তনকে প্রতিনিধিত্ব করে না।

changes[]

object ( ChangeHistoryChange )

এই পরিবর্তন ইতিহাস ইভেন্টে করা পরিবর্তনগুলির একটি তালিকা যা SearchChangeHistoryEventsRequest-এ নির্দিষ্ট করা ফিল্টারগুলির সাথে মেলে।

অভিনেতার ধরন

বিভিন্ন ধরনের পক্ষ যারা গুগল অ্যানালিটিক্স রিসোর্সে পরিবর্তন আনতে পারে।

এনাম
ACTOR_TYPE_UNSPECIFIED অজানা বা অনির্দিষ্ট অভিনেতার ধরণ।
USER actorEmail-এ নির্দিষ্ট ব্যবহারকারী কর্তৃক করা পরিবর্তনসমূহ।
SYSTEM গুগল অ্যানালিটিক্স সিস্টেম দ্বারা করা পরিবর্তনসমূহ।
SUPPORT গুগল অ্যানালিটিক্স সাপোর্ট টিমের কর্মীরা পরিবর্তনগুলো করেছেন।

ইতিহাস পরিবর্তন

একটিমাত্র গুগল অ্যানালিটিক্স রিসোর্সের পরিবর্তনের বিবরণ।

JSON উপস্থাপনা 
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
ক্ষেত্র
resource

string

এই এন্ট্রিতে যে রিসোর্সের পরিবর্তনগুলো বর্ণনা করা হয়েছে, তার নাম।

action

enum ( ActionType )

যে ধরনের কার্যকলাপ এই সম্পদটিকে পরিবর্তন করেছে।

resourceBeforeChange

object ( ChangeHistoryResource )

পরিবর্তনটি করার আগের রিসোর্সের বিষয়বস্তু। যদি এই পরিবর্তনের ফলে রিসোর্সটি তৈরি হয়ে থাকে, তাহলে এই ফিল্ডটি অনুপস্থিত থাকবে।

resourceAfterChange

object ( ChangeHistoryResource )

পরিবর্তনটি করার পরের রিসোর্সের বিষয়বস্তু। যদি এই পরিবর্তনে রিসোর্সটি মুছে ফেলা হয়, তাহলে এই ফিল্ডটি অনুপস্থিত থাকবে।

ChangeHistoryResource

পরিবর্তনের ইতিহাসে কোনো পরিবর্তনের ফলাফলের আগে বা পরের একটি রিসোর্সের স্ন্যাপশট।

JSON উপস্থাপনা 
{

  // Union field resource can be only one of the following:
  "account": {
    object (Account)
  },
  "property": {
    object (Property)
  },
  "firebaseLink": {
    object (FirebaseLink)
  },
  "googleAdsLink": {
    object (GoogleAdsLink)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "dataStream": {
    object (DataStream)
  }
  // End of list of possible types for union field resource.
}
ক্ষেত্র

ইউনিয়ন ফিল্ড resource ।

resource নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

account

object ( Account )

পরিবর্তনের ইতিহাসে একটি অ্যাকাউন্ট রিসোর্সের স্ন্যাপশট।

property

object ( Property )

পরিবর্তনের ইতিহাসে একটি Property রিসোর্সের স্ন্যাপশট।

conversionEvent

object ( ConversionEvent )

পরিবর্তনের ইতিহাসে একটি ConversionEvent রিসোর্সের স্ন্যাপশট।

measurementProtocolSecret

object ( MeasurementProtocolSecret )

পরিবর্তনের ইতিহাসে একটি MeasurementProtocolSecret রিসোর্সের স্ন্যাপশট।

dataRetentionSettings

object ( DataRetentionSettings )

পরিবর্তনের ইতিহাসে ডেটা ধরে রাখার সেটিংস রিসোর্সের একটি স্ন্যাপশট।

dataStream

object ( DataStream )

পরিবর্তনের ইতিহাসে থাকা একটি ডেটাস্ট্রিম রিসোর্সের স্ন্যাপশট।