Method: accounts.searchChangeHistoryEvents

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

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

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

POST https://analyticsadmin.googleapis.com/v1alpha/{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)

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

यह RFC 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)

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

यह RFC 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 संसाधन
EXPANDED_DATA_SET ExpandedDataSet संसाधन
CHANNEL_GROUP ChannelGroup संसाधन
ENHANCED_MEASUREMENT_SETTINGS EnhancedMeasurementSettings संसाधन
DATA_REDACTION_SETTINGS DataRedactionSettings संसाधन
SKADNETWORK_CONVERSION_VALUE_SCHEMA SKAdNetworkConversionValueSchema संसाधन
AUDIENCE ऑडियंस संसाधन
EVENT_CREATE_RULE EventCreateRule संसाधन
KEY_EVENT KeyEvent संसाधन
CALCULATED_METRIC CalculatedMetric संसाधन
REPORTING_DATA_ANNOTATION ReportingDataAnnotation संसाधन
SUBPROPERTY_SYNC_CONFIG SubpropertySyncConfig संसाधन
REPORTING_IDENTITY_SETTINGS ReportingIdentitySettings संसाधन

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)

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

यह RFC 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)
  },
  "googleSignalsSettings": {
    object (GoogleSignalsSettings)
  },
  "displayVideo360AdvertiserLink": {
    object (DisplayVideo360AdvertiserLink)
  },
  "displayVideo360AdvertiserLinkProposal": {
    object (DisplayVideo360AdvertiserLinkProposal)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "customDimension": {
    object (CustomDimension)
  },
  "customMetric": {
    object (CustomMetric)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "searchAds360Link": {
    object (SearchAds360Link)
  },
  "dataStream": {
    object (DataStream)
  },
  "attributionSettings": {
    object (AttributionSettings)
  },
  "expandedDataSet": {
    object (ExpandedDataSet)
  },
  "channelGroup": {
    object (ChannelGroup)
  },
  "bigqueryLink": {
    object (BigQueryLink)
  },
  "enhancedMeasurementSettings": {
    object (EnhancedMeasurementSettings)
  },
  "dataRedactionSettings": {
    object (DataRedactionSettings)
  },
  "skadnetworkConversionValueSchema": {
    object (SKAdNetworkConversionValueSchema)
  },
  "adsenseLink": {
    object (AdSenseLink)
  },
  "audience": {
    object (Audience)
  },
  "eventCreateRule": {
    object (EventCreateRule)
  },
  "keyEvent": {
    object (KeyEvent)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  },
  "reportingDataAnnotation": {
    object (ReportingDataAnnotation)
  },
  "subpropertySyncConfig": {
    object (SubpropertySyncConfig)
  },
  "reportingIdentitySettings": {
    object (ReportingIdentitySettings)
  }
  // End of list of possible types for union field resource.
}
फ़ील्ड

यूनियन फ़ील्ड resource.

resource इनमें से सिर्फ़ एक हो सकता है:

account

object (Account)

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

property

object (Property)

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

googleSignalsSettings

object (GoogleSignalsSettings)

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

conversionEvent

object (ConversionEvent)

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

measurementProtocolSecret

object (MeasurementProtocolSecret)

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

customDimension

object (CustomDimension)

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

customMetric

object (CustomMetric)

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

dataRetentionSettings

object (DataRetentionSettings)

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

dataStream

object (DataStream)

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

attributionSettings

object (AttributionSettings)

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

expandedDataSet

object (ExpandedDataSet)

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

channelGroup

object (ChannelGroup)

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

enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

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

dataRedactionSettings

object (DataRedactionSettings)

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

skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

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

audience

object (Audience)

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

eventCreateRule

object (EventCreateRule)

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

keyEvent

object (KeyEvent)

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

calculatedMetric

object (CalculatedMetric)

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

reportingDataAnnotation

object (ReportingDataAnnotation)

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

subpropertySyncConfig

object (SubpropertySyncConfig)

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

reportingIdentitySettings

object (ReportingIdentitySettings)

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