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 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

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

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
pageSize

integer

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

ध्यान दें कि सेवा, इस वैल्यू में बताए गए आइटम की संख्या से कम आइटम वाला पेज दिखा सकती है. ऐसा भी हो सकता है कि पेज पर कोई आइटम न दिखे. साथ ही, ऐसा भी हो सकता है कि अब भी कुछ और पेज मौजूद हों. अगर आपको किसी खास संख्या में आइटम चाहिए, तो आपको 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

उन संसाधनों के टाइप जिनके बदलावों की जानकारी, बदलाव के इतिहास से मिल सकती है.

Enums
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED संसाधन का टाइप मौजूद नहीं है या इसके बारे में जानकारी नहीं दी गई है.
ACCOUNT खाता संसाधन
PROPERTY प्रॉपर्टी संसाधन
GOOGLE_SIGNALS_SETTINGS GoogleSignalsSettings संसाधन
CONVERSION_EVENT ConversionEvent संसाधन
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret रिसॉर्स
CUSTOM_DIMENSION CustomDimension संसाधन
CUSTOM_METRIC CustomMetric संसाधन
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 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
actorType

enum (ActorType)

बदलाव करने वाले व्यक्ति का टाइप.
userActorEmail

string

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

boolean

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

object (ChangeHistoryChange)

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

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 संसाधन का स्नैपशॉट.