Method: accounts.searchChangeHistoryEvents

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

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

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
account

string

ज़रूरी है. वह खाता संसाधन जिसके लिए बदलाव के इतिहास के संसाधन दिखाने हैं. फ़ॉर्मैट: accounts/{account} उदाहरण: "accounts/100"

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
फ़ील्ड
property

string

ज़रूरी नहीं. किसी चाइल्ड प्रॉपर्टी के लिए संसाधन का नाम. अगर इस नीति को सेट किया जाता है, तो सिर्फ़ इस प्रॉपर्टी या इसके चाइल्ड रिसॉर्स में किए गए बदलाव दिखाएं. फ़ॉर्मैट: प्रॉपर्टीज़/{propertyId} उदाहरण: "properties/100"
resourceType[]

enum (ChangeHistoryResourceType)

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

enum (ActionType)

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

string

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

string (Timestamp format)

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

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

string (Timestamp format)

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

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

integer

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

string

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

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

Search Account RPC के लिए रिस्पॉन्स मैसेज.

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

जेएसओएन के काेड में दिखाना 
{
  "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 कन्वर्ज़न इवेंट के लिए संसाधन
MEASUREMENT_PROTOCOL_SECRET मेज़रमेंटProtocolSecret संसाधन
DATA_RETENTION_SETTINGS डेटा रिटेंशन सेटिंग के लिए संसाधन
DATA_STREAM DataStream के लिए संसाधन
ATTRIBUTION_SETTINGS AttributionSettings संसाधन

ActionType

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

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

ChangeHistoryEvent

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

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

string

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

string (Timestamp format)

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

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

enum (ActorType)

किस तरह के कलाकार ने यह बदलाव किया.
userActorEmail

string

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

boolean

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

object (ChangeHistoryChange)

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

ActorType

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

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

ChangeHistoryChange

Google Analytics के किसी संसाधन में हुए बदलाव का ब्यौरा.

जेएसओएन के काेड में दिखाना 
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
फ़ील्ड
resource

string

उस संसाधन के संसाधन का नाम जिसके बदलावों की जानकारी इस एंट्री में दी गई है.
action

enum (ActionType)

वह कार्रवाई जिसकी वजह से इस संसाधन में बदलाव हुआ.
resourceBeforeChange

object (ChangeHistoryResource)

बदलाव करने से पहले का संसाधन सामग्री. अगर यह संसाधन इस बदलाव में बनाया गया था, तो यह फ़ील्ड मौजूद नहीं होगा.
resourceAfterChange

object (ChangeHistoryResource)

बदलाव के बाद का संसाधन सामग्री. अगर इस बदलाव में यह संसाधन मिटा दिया गया था, तो यह फ़ील्ड मौजूद नहीं होगा.

ChangeHistoryResource

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

जेएसओएन के काेड में दिखाना 
{

  // 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)

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

object (DataRetentionSettings)

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

object (DataStream)

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