Method: accounts.searchChangeHistoryEvents

फ़िल्टर के किसी सेट के आधार पर, किसी खाते या उसके चाइल्ड एंट्री में किए गए सभी बदलावों की खोज करता है.

एचटीटीपी अनुरोध

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

यूआरएल में 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)

ज़रूरी नहीं. अगर यह सेट है, तो इस समय के बाद किए गए बदलाव ही दिखाए जाएंगे.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
latestChangeTime

string (Timestamp format)

ज़रूरी नहीं. अगर यह सेट किया गया है, तो इस समय से पहले किए गए बदलाव ही दिखाए जाएंगे.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
pageSize

integer

ज़रूरी नहीं. ChangeHistoryEvent आइटम की ज़्यादा से ज़्यादा संख्या. अतिरिक्त पेज होने पर भी, सेवा इस वैल्यू से कम नतीजे दिखा सकती है. अगर जानकारी नहीं दी गई है, तो ज़्यादा से ज़्यादा 50 आइटम लौटाए जाएंगे. ज़्यादा से ज़्यादा वैल्यू 200 है. ज़्यादा बड़ी वैल्यू को ज़्यादा से ज़्यादा वैल्यू माना जाएगा.
pageToken

string

ज़रूरी नहीं. पेज टोकन, जो पिछले accounts.searchChangeHistoryEvents कॉल से मिला था. अगला पेज देखने के लिए, यह डालें. पेजों पर नंबर डालते समय, accounts.searchChangeHistoryEvents को दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मैच होने चाहिए.

जवाब का मुख्य भाग

SearchAccounts आरपीसी के लिए रिस्पॉन्स मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
changeHistoryEvents[]

object (ChangeHistoryEvent)

ऐसे नतीजे जिन्हें कॉलर ऐक्सेस कर सकता था.
nextPageToken

string

एक टोकन, जिसे अगले पेज को वापस पाने के लिए pageToken के तौर पर भेजा जा सकता है. अगर इस फ़ील्ड को छोड़ा जाता है, तो इसके बाद कोई पेज नहीं दिखेगा.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ChangeHistoryResourceType

ऐसे संसाधन जिनके बदलावों को बदलाव के इतिहास से दिखाया जा सकता है.

Enums
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED संसाधन का टाइप अज्ञात है या इसके बारे में जानकारी नहीं दी गई है.
ACCOUNT खाता संसाधन
PROPERTY प्रॉपर्टी का संसाधन
GOOGLE_SIGNALS_SETTINGS GoogleSignalsSettings संसाधन
CONVERSION_EVENT ConversionEvent रिसॉर्स
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret रिसॉर्स
DATA_RETENTION_SETTINGS DataRetentionSettings रिसॉर्स
DATA_STREAM DataStream रिसॉर्स
ATTRIBUTION_SETTINGS AttributionSettings संसाधन

ActionType

ऐसी कार्रवाइयों के टाइप जिनसे किसी रिसॉर्स में बदलाव हो सकता है.

Enums
ACTION_TYPE_UNSPECIFIED कार्रवाई का टाइप अज्ञात है या इसकी जानकारी नहीं दी गई है.
CREATED इस बदलाव में संसाधन बनाया गया था.
UPDATED इस बदलाव में, संसाधन को अपडेट किया गया था.
DELETED इस बदलाव में, संसाधन मिटा दिया गया था.

ChangeHistoryEvent

Google Analytics खाते या उसकी चाइल्ड प्रॉपर्टी में एक ही वजह से हुए बदलावों का सेट. इसकी सामान्य वजहें हो सकती हैं: Google Analytics के यूज़र इंटरफ़ेस (यूआई) में किए गए अपडेट, ग्राहक सहायता में किए गए बदलाव या Google Analytics के सिस्टम में अपने-आप होने वाले बदलाव.

JSON के काेड में दिखाना 
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
फ़ील्ड
id

string

बदलाव के इतिहास से जुड़े इस इवेंट का आईडी. यह आईडी पूरे Google Analytics में यूनीक होता है.
changeTime

string (Timestamp format)

बदलाव करने का समय.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
actorType

enum (ActorType)

बदलाव करने वाले ऐक्टर का टाइप.
userActorEmail

string

उस Google खाते का ईमेल पता जिसने बदलाव किया है. अगर 'ऐक्टर' फ़ील्ड को 'उपयोगकर्ता' पर सेट किया गया है, तो यह एक मान्य ईमेल पता होगा. अगर ऐसा नहीं है, तो यह खाली होगा. मिटाए गए Google खातों की वजह से गड़बड़ी होगी.
changesFiltered

boolean

अगर यह सही है, तो बदलावों की लिस्ट को फ़िल्टर किया गया था. इसमें इस इवेंट में हुए सभी बदलाव शामिल नहीं हैं.
changes[]

object (ChangeHistoryChange)

बदलाव के इतिहास के इस इवेंट में किए गए बदलावों की सूची, जो SearchChangeइतिहासEventsRequest में तय किए गए फ़िल्टर के मुताबिक है.

ActorType

Google Analytics के रिसॉर्स में बदलाव करने वाले अलग-अलग तरह के उपयोगकर्ता.

Enums
ACTOR_TYPE_UNSPECIFIED अज्ञात या एक्टर टाइप की जानकारी नहीं दी गई है.
USER actorEmail में बताए गए उपयोगकर्ता ने जो बदलाव किए हैं.
SYSTEM Google Analytics सिस्टम से किए गए बदलाव.
SUPPORT Google Analytics की सहायता टीम के कर्मचारियों ने जो बदलाव किए हैं.

ChangeHistoryChange

Google Analytics के किसी एक संसाधन में किए गए बदलाव के बारे में जानकारी.

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)

बदलाव के इतिहास में मौजूद प्रॉपर्टी संसाधन का स्नैपशॉट.
conversionEvent

object (ConversionEvent)

बदलाव के इतिहास में मौजूद ConversionEvent रिसॉर्स का स्नैपशॉट.
measurementProtocolSecret

object (MeasurementProtocolSecret)

बदलाव के इतिहास में, MeasurementProtocolSecret संसाधन का स्नैपशॉट.
dataRetentionSettings

object (DataRetentionSettings)

बदलाव के इतिहास में, डेटा के रखरखाव की सेटिंग से जुड़े संसाधन का स्नैपशॉट.
dataStream

object (DataStream)

बदलाव के इतिहास में, DataStream संसाधन का स्नैपशॉट.