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

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

resourceType[]

enum (ChangeHistoryResourceType)

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

action[]

enum (ActionType)

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

actorEmail[]

string

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

earliestChangeTime

string (Timestamp format)

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

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

latestChangeTime

string (Timestamp format)

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

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

pageSize

integer

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

pageToken

string

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

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

Search accounts 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 कन्वर्ज़न इवेंट संसाधन
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret संसाधन
DATA_RETENTION_SETTINGS डेटा के रखरखाव की सेटिंग से जुड़ा संसाधन
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 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

actorType

enum (ActorType)

उस कलाकार का टाइप जिसने यह बदलाव किया.

userActorEmail

string

उस Google खाते का ईमेल पता जिससे बदलाव किया गया. अगर उपयोगकर्ता फ़ील्ड को USER पर सेट किया गया है, तो यह एक मान्य ईमेल पता होगा. ऐसा न होने पर, यह फ़ील्ड खाली होगा. जिन 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 संसाधन का स्नैपशॉट.