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

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

ध्यान दें कि सेवा, इस वैल्यू से कम आइटम वाला पेज दिखा सकती है. ऐसा हो सकता है कि पेज पर कोई आइटम न हो. इसके बावजूद, हो सकता है कि और पेज भी हों. अगर आपको किसी खास संख्या में आइटम चाहिए, तो आपको pageToken का इस्तेमाल करके, तब तक अतिरिक्त पेजों का अनुरोध करना होगा, जब तक आपको ज़रूरत के मुताबिक आइटम न मिल जाएं.
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 रिसॉर्स
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 खाते से बदलाव किया गया है उसका ईमेल पता. अगर 'ऐक्टर' फ़ील्ड को 'उपयोगकर्ता' पर सेट किया गया है, तो यह एक मान्य ईमेल पता होगा. अगर ऐसा नहीं है, तो यह खाली होगा. मिटाए गए Google खातों की वजह से गड़बड़ी होगी.
changesFiltered

boolean

अगर यह सही है, तो बदलावों की लिस्ट को फ़िल्टर किया गया था. इसमें इस इवेंट में हुए सभी बदलाव शामिल नहीं हैं.
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 संसाधन का स्नैपशॉट.