PostUserInfos: liste
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Yetkilendirme gerektirir.
Yayın ve yayın kullanıcısı bilgisi çiftlerinin listesini (filtrelenmiş olabilir) alır. Yayın kullanıcı bilgileri, yayınla ilgili kullanıcı başına bilgileri (ör. kullanıcıya özel erişim hakları) içerir.
Şimdi deneyin.
İstek
HTTP isteği
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
Parametreler
| Parametre adı |
Değer |
Açıklama |
| Gerekli parametreler |
blogId |
string |
Yayınları getirilecek blogun kimliği.
|
userId |
string |
Kullanıcı başına bilgilerin getirileceği kullanıcının kimliği. "Kendim" kelimesi (tırnak işareti olmadan) veya kullanıcının profil tanımlayıcısı.
|
| İsteğe bağlı parametreler |
endDate |
datetime |
Getirilecek en son yayın tarihi. RFC 3339 biçiminde bir tarih ve saat.
|
fetchBodies |
boolean |
Yayının gövde içeriğinin dahil edilip edilmeyeceği. false varsayılandır.
(Varsayılan: false)
|
labels |
string |
Aranacak etiketlerin virgülle ayrılmış listesi.
|
maxResults |
unsigned integer |
Getirilecek maksimum yayın sayısı.
|
orderBy |
string |
Arama sonuçlarına uygulanan sıralama düzeni. published varsayılandır.
Kabul edilen değerler şunlardır:
- "
published": Yayının yayınlandığı tarihe göre sıralama
- "
updated": Yayınların son güncellenme tarihine göre sıralama
|
pageToken |
string |
Büyük sonuç kümelerinde sayfalama yapmak için kullanılan devam jetonu. Sonuçların bir sonraki sayfasını almak için bu parametreyi önceki yanıttaki "nextPageToken" değerine ayarlayın.
|
startDate |
datetime |
Getirilecek en erken gönderi tarihi. RFC 3339 biçiminde bir tarih-saat.
|
status |
string |
Kabul edilen değerler şunlardır:
- "
draft": Taslak yayınlar
- "
live": Yayınlanan yayınlar
- "
scheduled": Gelecekte yayınlanması planlanan gönderiler.
|
view |
string |
Kabul edilen değerler şunlardır:
- "
ADMIN": Yönetici düzeyinde ayrıntı
- "
AUTHOR": Yazar düzeyinde ayrıntı
- "
READER": Okuyucu düzeyinde ayrıntı
|
Yetkilendirme
Bu istek, aşağıdaki kapsamlardan en az birinde yetkilendirme gerektirir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).
| Kapsam |
|---|
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
İstek içeriği
Bu yöntemle istek gövdesi sağlamayınız.
Yanıt
Başarılı olursa bu yöntem aşağıdaki yapıya sahip bir yanıt metni döndürür:
{
"kind": "blogger#postUserInfosList",
"nextPageToken": string,
"items": [
postUserInfos Resource
]
}
| Mülk adı |
Değer |
Açıklama |
Notlar |
kind |
string |
Bu varlığın türü. Her zaman blogger#postList |
|
nextPageToken |
string |
Sonraki sayfayı (varsa) almak için sayfalandırma jetonu. |
|
items[] |
list |
Bu blogdaki yayınların, yayınla ilgili kullanıcı bilgilerini içeren listesi. |
|
Deneyin!
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-11-30 UTC.
[null,null,["Son güncelleme tarihi: 2024-11-30 UTC."],[[["\u003cp\u003eRetrieves a list of posts and user-specific information for those posts from a specified blog.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of posts by date, labels, status, and other criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns paginated results with post and user information.\u003c/p\u003e\n"],["\u003cp\u003eCan be tested using the provided API Explorer.\u003c/p\u003e\n"]]],[],null,["# PostUserInfos: list\n\n**Requires [authorization](#auth)**\n\nRetrieves a list of post and post user info pairs, possibly filtered. The post user info contains per-user information about the post, such as access rights, specific to the user.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | ID of the blog to fetch posts from. |\n| `userId` | `string` | ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier. |\n| **Optional parameters** |||\n| `endDate` | `datetime` | Latest post date to fetch, a date-time with RFC 3339 formatting. |\n| `fetchBodies` | `boolean` | Whether to include the post's body content. Default is `false`. (Default: `false`) |\n| `labels` | `string` | Comma-separated list of labels to search for. |\n| `maxResults` | `unsigned integer` | Maximum number of posts to fetch. |\n| `orderBy` | `string` | Sort order applied to search results. Default is `published`. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`published`\": Order by the date the post was published - \"`updated`\": Order by the date the post was last updated |\n| `pageToken` | `string` | The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of \"nextPageToken\" from the previous response. |\n| `startDate` | `datetime` | Earliest post date to fetch, a date-time with RFC 3339 formatting. |\n| `status` | `string` | Acceptable values are: - \"`draft`\": Draft posts - \"`live`\": Published posts - \"`scheduled`\": Posts that are scheduled to publish in future. |\n| `view` | `string` | Acceptable values are: - \"`ADMIN`\": Admin level detail - \"`AUTHOR`\": Author level detail - \"`READER`\": Reader level detail |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/blogger/docs/3.0/using#auth)).\n\n| Scope |\n|----------------------------------------------------|\n| `https://www.googleapis.com/auth/blogger` |\n| `https://www.googleapis.com/auth/blogger.readonly` |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"blogger#postUserInfosList\",\n \"nextPageToken\": string,\n \"items\": [\n postUserInfos Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-----------------|----------|----------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#postList` | |\n| `nextPageToken` | `string` | Pagination token to fetch the next page, if one exists. | |\n| `items[]` | `list` | The list of Posts with User information for the post, for this Blog. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
